30分钟搞定AnythingLLM本地开发：从环境到启动全攻略

你还在为LLM应用本地部署踩坑？依赖冲突、配置繁琐、启动失败？本文30分钟带你从零搭建AnythingLLM开发环境，顺利运行本地服务。读完你将获得：Docker与手动部署双方案、环境配置避坑指南、前后端服务启动全流程。

项目简介

AnythingLLM是一个全栈应用程序，可将任何文档、资源（如网址链接、音频、视频）或内容片段转换为上下文，供大语言模型（LLM）在聊天时参考。支持多用户管理、权限设置及多种LLM和向量数据库选择。

技术架构包含六个主要部分：

• frontend: ViteJS + React前端
• server: NodeJS express服务器
• collector: 文档处理服务器
• docker: Docker部署相关文件
• embed: Web嵌入组件
• browser-extension: 浏览器扩展

环境准备

系统要求

• Docker（推荐）或Node.js 16+、Yarn
• Git
• 至少2GB RAM，10GB磁盘空间

克隆代码仓库

git clone https://gitcode.com/GitHub_Trending/an/anything-llm.git
cd anything-llm

部署方案

方案一：Docker快速部署（推荐）

Docker部署可避免环境依赖问题，适合大多数用户。

1. 创建存储目录

export STORAGE_LOCATION=$HOME/anythingllm && \
mkdir -p $STORAGE_LOCATION && \
touch "$STORAGE_LOCATION/.env"

2. 启动Docker容器

docker run -d -p 3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm

Windows用户请使用PowerShell执行：

$env:STORAGE_LOCATION="$HOME\Documents\anythingllm"; `
If(!(Test-Path $env:STORAGE_LOCATION)) {New-Item $env:STORAGE_LOCATION -ItemType Directory}; `
If(!(Test-Path "$env:STORAGE_LOCATION\.env")) {New-Item "$env:STORAGE_LOCATION\.env" -ItemType File}; `
docker run -d -p 3001:3001 `
--cap-add SYS_ADMIN `
-v "$env:STORAGE_LOCATION`:/app/server/storage" `
-v "$env:STORAGE_LOCATION\.env:/app/server/.env" `
-e STORAGE_DIR="/app/server/storage" `
mintplexlabs/anythingllm;

3. 访问应用 打开浏览器访问 http://localhost:3001

方案二：手动部署（开发人员）

适合需要修改源码或自定义配置的场景。

1. 初始化环境

yarn setup

该命令会创建必要的.env文件，请根据提示填写配置信息，特别是server/.env.development。

2. 安装依赖

分别安装前端、服务器和文档处理器的依赖：

# 安装服务器依赖
cd server
yarn install
cd ..

# 安装前端依赖
cd frontend
yarn install
cd ..

# 安装文档处理器依赖
cd collector
yarn install
cd ..

3. 启动服务

需要分别启动三个服务：

# 启动服务器
yarn dev:server

# 启动前端（新终端）
yarn dev:frontend

# 启动文档处理器（新终端）
yarn dev:collector

4. 初始化数据库

cd server
npx prisma migrate dev
cd ..

配置与使用

访问应用

打开浏览器访问 http://localhost:3001，首次使用需创建管理员账户。

主要功能

• 创建工作区：用于组织文档和对话
• 上传文档：支持PDF、DOCX、TXT等多种格式
• 设置LLM：可配置OpenAI、Ollama等多种LLM提供商
• 聊天交互：与文档内容进行智能对话

开发指南

项目结构

• frontend/: 前端React应用
• server/: Node.js后端服务
• collector/: 文档处理服务
• docker/: Docker配置文件

开发命令

• 前端开发：yarn dev:frontend
• 后端开发：yarn dev:server
• 代码检查：yarn lint

贡献代码

请参考CONTRIBUTING.md了解贡献指南。

常见问题

无法连接本地LLM服务？

Docker容器中访问本地服务需使用host.docker.internal代替localhost，如Ollama地址应设为http://host.docker.internal:11434。

如何修改默认端口？

编辑.env文件，修改PORT环境变量。

数据存储位置？

• Docker部署：$HOME/anythingllm
• 手动部署：server/storage/

总结

通过本文指南，你已成功搭建AnythingLLM本地开发环境。无论是使用Docker快速部署还是手动配置开发环境，都能让你快速体验到AnythingLLM的强大功能。如需进一步定制，可参考官方文档或查看源码进行二次开发。

如果你觉得本教程有帮助，请点赞收藏，关注获取更多LLM应用开发技巧！

参考资料

• 官方文档
• Docker部署指南
• 模型存储说明