【免费下载链接】T8-penguin-canvas

项目地址： https://gitcode.com/gh_mirrors/t8/T8-penguin-canvas

点击查看 免费下载

T8-penguin-canvas 是一个面向创作场景的 AI 无限画布项目，把 AI 绘图、文生视频、ComfyUI 工作流、素材库和节点编排整合在一个画布工作台里。本文用一条 docker compose 命令完成 Docker 部署，帮你快速跑起 Web 前端加 Express 后端，并开启远端 ComfyUI 接入，适合不想折腾 Node 环境的新手用户。

部署前你需要知道什么

Docker 部署只运行 Web 前端 + Express 后端，不包含 Electron 桌面端，默认对外暴露 18766 端口，所有用户数据保存在挂载的 userdata 目录里。

镜像基于 Dockerfile 构建，内部做了三件关键的事：

步骤	内容
前端构建	node:22-bookworm-slim 环境下 npm run build 产出 dist
依赖安装	后端依赖以 --omit=dev 安装，保持镜像精简
运行时依赖	预装 ffmpeg 和 python3，支持视频帧提取等后端能力

数据目录结构（/app/userdata）对应 backend/src/server.js 中挂载的 output / input / thumbnails 等静态媒体目录，生成结果、上传素材都会落在这里。

快速开始：一条命令启动

第 1 步：获取源码

git clone https://gitcode.com/gh_mirrors/t8/T8-penguin-canvas
cd T8-penguin-canvas

第 2 步：一键构建并启动

docker compose up -d --build

第 3 步：访问验证

启动后在浏览器打开：

• Web 界面：http://127.0.0.1:18766
• 健康检查：http://127.0.0.1:18766/api/status

健康检查接口返回 ok: true、服务名、版本号和启动就绪状态（见 backend/src/server.js），看到它说明后端已经正常监听。

配置 API Key 才能开始生成

容器跑起来只是第一步。首次进入后点击右上角 ⚙️ 打开设置弹窗，按需填写：

• 贞贞工坊 API Key：图像 / 视频 / 音频生成
• LLM 独立 API Key：对话与视觉理解，支持任意 OpenAI 兼容上游
• RunningHub API Key：个人工作流
• ComfyUI 地址：默认 http://127.0.0.1:8188

不需要全部配置，只填要用的那一类即可，其它节点运行时才会提示「未配置 XXX API Key」。密钥保存在数据目录的 data/settings.json，前端接口只返回脱敏值，明文仅供后端本地代理使用。

远端 ComfyUI 接入（Docker 部署的重点）

这是 Docker 部署与本地部署最大的差异点：容器里的 localhost 指容器自身，不是宿主机。

默认安全策略

ComfyUI 默认只允许连接本机 localhost / 127.0.0.1，判断逻辑见 backend/src/providers/comfyuiAccess.js。

随附 Compose 已开启远端访问

docs 说明 中随附的 docker-compose.yml 已设置：

environment:
  T8_COMFYUI_ALLOW_REMOTE: "1"

这让你可以直接连接其他主机或另一个容器里的 ComfyUI（比如 GPU 服务器上的 http://192.168.1.50:8188）。该行为有自动化测试守护：tests/dockerComposeConfig.test.ts 会校验 Compose 配置中远端开关必须开启。

三条实用注意事项

1. 地址必须从容器网络视角可达：连接宿主机 ComfyUI 时，请填宿主机在 Docker 网络中的可达地址，而不是 127.0.0.1；
2. 只在可信网络中开启远端访问：这是一个显式的高危开关，不要把服务暴露到不可信网络；
3. 不想要全局远端？ 把该变量改为 "0" 或移除，再在 API 设置页里按单个 ComfyUI 配置手动开启「允许远端地址」开关，粒度更细、更安全。

数据持久化与常用运维命令

volumes 将宿主机 ./userdata 挂载到容器 /app/userdata，画布文档、生成结果、上传素材和设置文件都在其中，容器重建不丢数据。

# 查看后端日志
docker compose logs -f

# 停止服务
docker compose down

# 更新源码后重新构建
docker compose up -d --build

💡 提示：userdata 目录就是项目的数据盘，重要画布建议定期备份这个目录。

常见问题排查

现象	可能原因与处理
打开 18766 端口无响应	容器未起来，docker compose ps 查看状态并看日志
/api/status 正常但页面打不开	检查宿主机防火墙是否放行 18766 端口
ComfyUI 连接超时	容器内 localhost 指向容器自身，请改用宿主机的实际可达 IP
视频处理相关报错	确认镜像包含 ffmpeg（构建脚本已自动安装）

小结

• 一条 docker compose up -d --build 完成 Web + 后端部署，端口 18766；
• 数据统一落在 ./userdata 挂载目录，天然持久化；
• 随附 Compose 已启用 T8_COMFYUI_ALLOW_REMOTE=1，方便对接远端 ComfyUI，记得只在可信网络中这样做；
• 想深入了解端口与安全降级策略，可继续阅读 README.md 与 backend/src/ 中的路由实现。

【免费下载链接】T8-penguin-canvas

项目地址： https://gitcode.com/gh_mirrors/t8/T8-penguin-canvas

点击查看 免费下载