WeKnora 云服务器部署完整指南

本文详细记录了在腾讯云 Ubuntu 服务器上从零部署 WeKnora 的完整过程，以及部署中遇到的各种问题与解决方案。

一、环境准备

项目	要求
云服务器	至少 4核CPU、8GB内存、20GB存储
操作系统	Ubuntu 22.04 LTS（推荐）
网络	需能访问外网（拉取 Docker 镜像）
安全组	云服务器放行 SSH(22) 和 前端端口（如 8080）

二、部署步骤

1. 安装 Docker 和 Docker Compose

curl -fsSL https://get.docker.com | sh

验证安装：

docker --version
docker compose version

2. 配置 Docker 镜像加速器（国内服务器必备）

创建配置文件：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF

重启 Docker：

sudo systemctl daemon-reload
sudo systemctl restart docker

3. 解决 Docker 权限问题

将当前用户加入docker组：

sudo usermod -aG docker $USER

⚠️ 必须重新登录服务器（退出 SSH 客户端再重连）才能生效。

4. 克隆 WeKnora 项目代码

因 GitHub 访问较慢，可使用代理加速：

git clone https://githubproxy.cc/https://github.com/Tencent/WeKnora.git
cd WeKnora

5. 配置环境变量（最关键的一步）

复制示例配置文件：

cp .env.example .env

6. 启动服务

docker compose up -d

查看容器状态：

docker compose ps

7. 查看日志（如遇启动失败）

docker compose logs app --tail=50

三、访问与后续配置

1. 访问地址

http://你的服务器公网IP:端口号

⚠️ 确保云服务商安全组已放行该端口。

2. 注册管理员账号

第一个注册的用户自动获得管理员权限。

3. 配置 AI 模型（Web 界面操作）

配置要使用的模型即可