跳转至

kitsu 项目管理工具搭建

Kitsu 官方网站

Kitsu 官方推荐安装方法

CGWire 官方主要通过 Docker Compose 部署 Kitsu，这不仅是生产环境的标准部署方式，也能保证 PostreSQL 数据库、Redis 缓存、API 后端（Gazu / Zou）以及前端界面的快速隔离与运行。

1. 前置条件准备

在 Linux 服务器（推荐 Ubuntu 20.04/22.04/24.04 LTS）上安装 Docker 与 Docker Compose，并启动服务：

sudo apt update && sudo apt install -y docker.io docker-compose-v2
sudo systemctl enable --now docker

2. 获取官方部署文件

克隆 CGWire 的 Docker 官方部署仓库并进入目录：

git clone https://github.com/cgwire/docker.git kitsu-docker
cd kitsu-docker

3. 配置环境变量 (.env)

复制默认环境变量模板并根据实际服务器环境修改：

cp env.example .env
nano .env

建议在 .env 中修改以下关键参数：

  • SECRET_KEY：修改为随机生成的密钥字符串（用于 Token 加密）。
  • ADMIN_EMAIL 与 ADMIN_PASSWORD：设置初始化管理员账号与密码（默认通常为 admin@example.com / mysecretpassword）。
  • HOST_URL：配置为服务器的访问 FQDN 域名或局域网 IP（例如 [http://192.168.1.100](http://192.168.1.100) 或 [http://kitsu.yourdomain.com](http://kitsu.yourdomain.com)）。

4. 启动 Kitsu 服务

运行 Docker Compose 启动全部关联容器服务：

# 启动后台容器组
docker compose up -d

# 检查容器运行状态
docker compose ps

5. 初始化数据库与管理员账号

容器正常运行后，执行数据库迁移并创建初始管理员账号：

# 执行数据库 migration
docker compose exec zou zou init-db

# 创建初始管理员账户（如果 .env 未自动配置）
docker compose exec zou zou create-admin --email admin@domain.com --password YourStrongPassword

6. 访问与登录

打开浏览器访问服务器 IP 或域名（默认端口为 80 或 .env 中指定的端口，如 http://<YOUR_SERVER_IP>），输入配置好的管理员账号密码即可登录使用。

说明与维护建议

  • 共享文件存储（S3/MinIO/NFS）：在实际影视/动画管线中，建议将 Kitsu 的素材预览图存储目录（var/lib/zou 或 MinIO S3 桶）挂载至独立的 NAS 或高性能 SSD 存储上。
  • 反向代理与 SSL：生产环境中，建议在 Kitsu 前端前增加 Nginx / OpenResty / Traefik 反向代理，配置 SSL 证书（HTTPS）以确保数据传输安全。