Merge branch 'main' of https://github.com/ddcat-ai/open-ai-canvas
Publish container images / Quality checks (push) Has been cancelled
Publish container images / Resolve build version (push) Has been cancelled
Publish container images / Build open-ai-canvas-backend (amd64) (push) Has been cancelled
Publish container images / Build open-ai-canvas-backend (arm64) (push) Has been cancelled
Publish container images / Build open-ai-canvas-web (multi) (push) Has been cancelled
Publish container images / Build open-ai-canvas-yingce-agent (multi) (push) Has been cancelled
Publish container images / Publish open-ai-canvas-backend manifest (push) Has been cancelled
Publish container images / Publish open-ai-canvas-web manifest (push) Has been cancelled
Publish container images / Publish open-ai-canvas-yingce-agent manifest (push) Has been cancelled
Publish container images / Publish release assets (push) Has been cancelled

This commit is contained in:
tongtong committed 2026-10-14 16:28:42 +08:00
commit 743b65f57f
573 files changed
+129685 -3164

No files matched your search

+27 -22
View File
@@ -120,6 +120,8 @@ Windows PowerShell 用户可在仓库根目录执行:
### Docker 开发与本地构建
以下命令用于本地开发或试运行。部署服务器并使用后台在线更新,请使用下文的官方 Release 镜像部署。
源码热更新:
```bash
@@ -133,7 +135,7 @@ LOCAL_UID=$(id -u) LOCAL_GID=$(id -g) \
docker compose -f docker-compose.local.yml up -d --build
```
默认前端端口为 `3000`、后端端口为 `8080`;端口冲突时可通过 `CANVAS_WEB_HOST_PORT` 和 `CANVAS_BACKEND_HOST_PORT` 覆盖。
热更新开发默认前端端口为 `3000`、后端端口为 `8080`;端口冲突时可通过 `CANVAS_WEB_HOST_PORT` 和 `CANVAS_BACKEND_HOST_PORT` 覆盖。本地构建编排只暴露 web 的 `3000`,后端留在容器网络内,不安装 Host Updater。
更多本地开发说明(包括时间线字幕转写)见[本地开发文档](docs/content/docs/backend/local-development.mdx)。
@@ -157,34 +159,37 @@ docker compose -f docker-compose.local.yml up -d --build
## 服务器部署
### 源码构建(推荐)
### 官方 Release 镜像(推荐,支持后台在线更新)
适用于 Linux 云服务器。脚本会安装 Docker、拉取源码、生成受保护的 `.env`,并启动 PostgreSQL、Redis、后端和网页:
适用于使用 systemd 的 Linux 服务器。先从 [GitHub Releases](https://github.com/ddcat-ai/open-ai-canvas/releases) 选择包含镜像、Host Updater 二进制和 `SHA256SUMS` 的已发布版本,将下方 `vX.Y.Z` 替换为该版本:
```bash
CANVAS_RELEASE=vX.Y.Z
curl -fsSL "https://raw.githubusercontent.com/ddcat-ai/open-ai-canvas/${CANVAS_RELEASE}/scripts/install-server-image.sh" \
| sudo env CANVAS_IMAGE_TAG="${CANVAS_RELEASE}" REPOSITORY_REF="${CANVAS_RELEASE}" bash
```
脚本使用 `docker-compose.deploy.yml`,启动 PostgreSQL、Redis、独立 `yingce-agent`、backend 和 web,由一次性 `migrate` 服务迁移数据库,并安装宿主机 Host Updater。backend、web、Agent 镜像会固定为对应 GHCR digest。默认访问 `http://服务器IP:3000`,安装完成后在“系统配置 → 系统更新”检查后续版本。
查看状态和日志:
```bash
cd /opt/open-ai-canvas
sudo docker compose --env-file .env -f docker-compose.deploy.yml ps
sudo docker compose --env-file .env -f docker-compose.deploy.yml logs -f --tail=200
```
### 源码构建与已有部署
需要运行自行修改的源码时,可以使用源码安装脚本:
```bash
curl -fsSL https://raw.githubusercontent.com/ddcat-ai/open-ai-canvas/main/scripts/install-server.sh | sudo bash
```
默认访问 `http://服务器IP:3000`。更新或排查:
脚本使用 PostgreSQL、Redis、独立 Agent 和源码构建叠加层,但不安装 Host Updater;该部署不属于后台在线更新管理范围,需自行构建、备份和升级。根目录的 `docker-compose.yml`、`docker-compose.local.yml` 和自行编写的两容器 SQLite 编排用于本地试运行,不作为默认服务器部署方案。
```bash
cd /opt/open-ai-canvas
sudo docker compose --env-file .env \
-f docker-compose.deploy.yml -f docker-compose.build.yml ps
sudo docker compose --env-file .env \
-f docker-compose.deploy.yml -f docker-compose.build.yml logs -f --tail=200
```
### 使用 GHCR 镜像
不需要源码时,可使用镜像部署脚本:
```bash
curl -fsSL https://raw.githubusercontent.com/ddcat-ai/open-ai-canvas/main/scripts/install-server-image.sh \
| sudo env CANVAS_IMAGE_TAG=v1.5.7.1 bash
```
脚本会先按指定 Release 拉取镜像,再解析并写入 `CANVAS_BACKEND_IMAGE`、`CANVAS_WEB_IMAGE` 的 GHCR digest;生产 Compose 不接受缺失 digest 的默认镜像或 `latest`。更新流程、数据库迁移、备份和回退说明见[系统更新文档](docs/content/docs/backend/system-update.mdx)。
已有 SQLite 或自定义 Compose 部署,不能只替换 Compose 文件或补装更新器就获得在线更新;应先核对原数据卷、完成备份和数据迁移。方案选择见 [Docker 部署](docs/content/docs/overview/docker.mdx),更新约束、备份和回退见[系统更新文档](docs/content/docs/backend/system-update.mdx)。
## 安全边界