部署 TRADIS

1. 准备环境

需要 Docker 与 Docker Compose。准备三个宿主机绝对目录，且备份目录必须位于项目目录之外：

mkdir -p /volume1/docker/tradis/data
mkdir -p /volume1/docker/tradis/projects
mkdir -p /volume1/docker/tradis/backups
cd /volume1/docker/tradis

2. 创建 .env

把下面内容保存为 .env，替换密钥、管理员密码、访问来源和三个目录。不要再沿用示例密码。

TRADIS_IMAGE=coracoo/tradis:v0.9.8.1
CLIENT_VERSION=v0.9.8.1
UPDATE_CHANNEL=stable
TRADIS_PORT=33335

JWT_SECRET=请替换为至少32字符的随机密钥
ADMIN_PASSWORD=请替换为强密码
ALLOWED_ORIGINS=http://192.168.1.10:33335

TRADIS_DATA_ROOT=/volume1/docker/tradis/data
PROJECT_ROOT=/volume1/docker/tradis/projects
BACKUP_ROOT=/volume1/docker/tradis/backups

APPSTORE_CDN_URL=https://tradis-templates.coracoo.deno.net
TRADIS_REMOTE_AGENT_BIND=
TRADIS_REMOTE_AGENT_PUBLIC_URL=
TRADIS_REMOTE_AGENT_PORT=33336
TRADIS_REMOTE_AGENT_IMAGE=

可用 openssl rand -base64 48 生成随机密钥。修改 JWT_SECRET 会使现有登录失效。ALLOWED_ORIGINS 要填写浏览器实际访问地址，多个来源用逗号分隔。

3. 创建 compose.yaml

保存为 compose.yaml。项目目录采用同路径双挂载，让 TRADIS 与宿主机 Docker 使用一致路径。

name: tradis
services:
  tradis:
    image: ${TRADIS_IMAGE:-coracoo/tradis:v0.9.8.1}
    container_name: tradis
    restart: unless-stopped
    environment:
      BACKEND_PORT: 8080
      CLIENT_VERSION: ${CLIENT_VERSION:-v0.9.8.1}
      UPDATE_CHANNEL: ${UPDATE_CHANNEL:-stable}
      JWT_SECRET: ${JWT_SECRET:?请配置 JWT 签名密钥}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD:?请配置管理员初始密码}
      ALLOWED_ORIGINS: ${ALLOWED_ORIGINS:?请配置浏览器访问来源}
      PROJECT_ROOT: ${PROJECT_ROOT:?请配置宿主机项目目录}
      BACKUP_ROOT: ${BACKUP_ROOT:?请配置宿主机备份目录}
      APPSTORE_CDN_URL: ${APPSTORE_CDN_URL:-https://tradis-templates.coracoo.deno.net}
      TRADIS_REMOTE_AGENT_BIND: ${TRADIS_REMOTE_AGENT_BIND:-}
      TRADIS_REMOTE_AGENT_PUBLIC_URL: ${TRADIS_REMOTE_AGENT_PUBLIC_URL:-}
      TRADIS_REMOTE_AGENT_IMAGE: ${TRADIS_REMOTE_AGENT_IMAGE:-}
    ports:
      - "${TRADIS_PORT:-33335}:8080"
      - "${TRADIS_REMOTE_AGENT_PORT:-33336}:33336"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ${TRADIS_DATA_ROOT:?请配置宿主机数据目录}:/app/client/backend/data
      - ${PROJECT_ROOT:?请配置宿主机项目目录}:/app/client/backend/project
      - ${PROJECT_ROOT:?请配置宿主机项目目录}:${PROJECT_ROOT:?请配置宿主机项目目录}
      - ${BACKUP_ROOT:?请配置宿主机备份目录}:${BACKUP_ROOT:?请配置宿主机备份目录}
    security_opt:
      - no-new-privileges:true

4. 启动与首次登录

docker compose up -d

访问 http://NAS地址:33335。默认用户名为 admin，密码为 .env 中配置的 ADMIN_PASSWORD；首次登录后立即在“全局设置 → 常规 → 安全设置”修改密码。

5. 升级

升级前备份数据目录和重要项目，再执行：

docker compose pull
docker compose up -d

升级完成后检查 Compose 项目、容器和通知是否正常。应用保护与安全更新不能替代独立的数据备份。

6. 可选：Go 远程 Agent

只有接入其他 NAS 时才配置。Controller 需要独立监听地址和外部可达的 TLS 地址：

TRADIS_REMOTE_AGENT_BIND=:33336
TRADIS_REMOTE_AGENT_PUBLIC_URL=wss://你的域名:33336/agent

在“设置 → 功能 → 远程设备”创建设备并复制页面生成的完整 Compose 配置。反向代理必须使用 TCP 透传，不能丢弃客户端证书；已部署 Agent 的设备升级时需使用最新配置重新部署。

Community

Community 当前仍是尚未正式发布的本地候选，不提供未经验证的部署命令。公开仓库：coracoo/tradis_docker ↗。