安装指南

本指南将详细介绍 AnythingLLM 的各种安装方式，您可以根据自己的需求选择最适合的方式。

方式一：桌面应用 (推荐新手)

桌面应用是开始使用 AnythingLLM 最简单的方式，无需任何技术背景。

下载安装

1. 访问 AnythingLLM 官方发布页面
2. 根据您的操作系统下载对应版本：
   • Windows: AnythingLLM-Setup.exe
   • macOS: AnythingLLM.dmg
   • Linux: AnythingLLM.AppImage

安装步骤

Windows

# 下载后双击运行安装程序
# 按照安装向导完成安装

macOS

# 下载 .dmg 文件
# 双击打开，将 AnythingLLM 拖拽到 Applications 文件夹
# 首次运行可能需要在系统偏好设置中允许运行

Linux

# 下载 .AppImage 文件
chmod +x AnythingLLM.AppImage
./AnythingLLM.AppImage

方式二：Docker 部署

Docker 部署适合有一定技术基础的用户，提供更好的隔离性和可移植性。

前置要求

• Docker 20.10+
• Docker Compose 2.0+
• 至少 4GB RAM

快速启动

# 拉取最新镜像
docker pull mintplexlabs/anythingllm:latest

# 运行容器
docker run -d \
  --name anythingllm \
  -p 3001:3001 \
  -v anythingllm_storage:/app/server/storage \
  -v anythingllm_hotdir:/app/collector/hotdir \
  -e STORAGE_DIR="/app/server/storage" \
  mintplexlabs/anythingllm:latest

使用 Docker Compose

创建 docker-compose.yml 文件：

version: '3.8'

services:
  anythingllm:
    image: mintplexlabs/anythingllm:latest
    container_name: anythingllm
    ports:
      - "3001:3001"
    volumes:
      - anythingllm_storage:/app/server/storage
      - anythingllm_hotdir:/app/collector/hotdir
    environment:
      - STORAGE_DIR=/app/server/storage
      - JWT_SECRET=your-random-jwt-secret
      - LLM_PROVIDER=openai
      - OPENAI_API_KEY=your-openai-api-key
    restart: unless-stopped

volumes:
  anythingllm_storage:
  anythingllm_hotdir:

启动服务：

docker-compose up -d

方式三：云端部署

Railway 部署

1. 访问 Railway
2. 点击 "Deploy Now" 按钮
3. 连接您的 GitHub 账户
4. Fork AnythingLLM 仓库
5. 配置环境变量
6. 部署完成

Render 部署

1. 访问 Render
2. 创建新的 Web Service
3. 连接 AnythingLLM GitHub 仓库
4. 配置构建和启动命令：

   # 构建命令
   yarn install && yarn build
   
   # 启动命令
   yarn start

Vercel 部署

# 安装 Vercel CLI
npm i -g vercel

# 克隆仓库
git clone https://github.com/Mintplex-Labs/anything-llm.git
cd anything-llm

# 部署
vercel --prod

方式四：源码部署

适合开发者或需要完全自定义的用户。

前置要求

• Node.js 18+
• Yarn 或 npm
• Python 3.8+ (用于文档处理)
• Git

安装步骤

# 克隆仓库
git clone https://github.com/Mintplex-Labs/anything-llm.git
cd anything-llm

# 安装依赖
yarn install

# 设置环境变量
cp .env.example .env
# 编辑 .env 文件配置您的设置

# 构建前端
yarn build

# 启动服务
yarn start

开发模式

# 启动开发服务器
yarn dev

# 前端开发服务器 (另一个终端)
cd frontend
yarn dev

环境变量配置

无论使用哪种部署方式，都需要配置以下关键环境变量：

# JWT 密钥 (必需)
JWT_SECRET=your-random-jwt-secret-here

# LLM 提供商配置
LLM_PROVIDER=openai
OPENAI_API_KEY=your-openai-api-key

# 向量数据库配置 (可选，默认使用 LanceDB)
VECTOR_DB=lancedb

# 存储配置
STORAGE_DIR=/app/server/storage

# 服务器配置
SERVER_PORT=3001

验证安装

安装完成后，访问 http://localhost:3001 (或您的部署地址) 来验证安装是否成功。

您应该看到 AnythingLLM 的欢迎页面和设置向导。

故障排除

常见问题

1. 端口冲突

   # 检查端口占用
   lsof -i :3001
   
   # 使用不同端口
   PORT=3002 yarn start

2. 权限问题 (Linux/macOS)

   # 确保有正确的文件权限
   sudo chown -R $USER:$USER ./storage

3. 内存不足

   # 增加 Node.js 内存限制
   NODE_OPTIONS="--max-old-space-size=4096" yarn start

下一步

安装完成后，请查看：

• 配置指南 - 配置您的 AnythingLLM 实例
• 用户指南 - 学习如何使用各项功能

---

提示

如果遇到安装问题，请查看 常见问题 或在 GitHub Issues 中寻求帮助。