安装

在你自己的机器或服务器上自托管 OpenTraderWorld。大约需要 5 分钟。

仅支持容器化（目前）

OpenTraderWorld 以 Docker Compose 堆栈运行，这是唯一受支持的部署方式。原生安装可行但不推荐：Docker 让安装不侵入系统（一切都在容器和卷中），并且能快速重建。原因以及各操作系统的安装步骤见获取 Docker。

要求

• 带 Docker Compose 的 Docker。还没有？获取 Docker 用几条命令涵盖了 macOS、Windows 和 Linux。
• Linux、macOS 或 Windows。
• 一个空闲端口（默认 5454；HTTPS 模式使用 80 + 443 端口）。可在设置过程中更改。

检查 Docker 是否就绪：

docker --version
docker compose version

一条命令安装（推荐）

curl -fsSL https://raw.githubusercontent.com/G-OTW/OpenTraderWorld/master/install.sh | bash

安装程序会检查 Docker 是否就绪，将部署文件（仅 deploy/ 目录，不含源代码和工具链）下载到 ./opentraderworld，然后交给下面的引导式设置，它会从 Docker Hub 拉取预构建镜像。

选项写在 bash -s -- 之后：

curl -fsSL https://raw.githubusercontent.com/G-OTW/OpenTraderWorld/master/install.sh | bash -s -- --dir ~/otw

选项	默认值	说明
--dir <path>	./opentraderworld	安装目录。目录非空或已有安装时拒绝执行。
--ref <ref>	master	要安装的分支或标签。
--build	关闭	克隆完整源码并在本地构建镜像，而不是拉取（需要 git 和工具链）。

通过 git 克隆（替代方式）

git clone https://github.com/G-OTW/OpenTraderWorld.git
cd OpenTraderWorld/deploy
./setup.sh

引导式设置

上面两种方式都会运行 deploy/setup.sh。它会问几个问题、生成高强度密钥、写入配置并启动所有服务。

它会提示：

问题	默认值	说明
网络模式	1（localhost）	1 仅本机 · 2 局域网明文 HTTP · 3 局域网 HTTPS（真实证书） · 4 使用你自己域名的公网。之后可更改，参见网络与远程访问。
管理员用户名	admin	会为你创建管理员账号；生成强密码并仅显示一次。
HTTP 端口	5454	仅模式 1–2；模式 3 和 4 使用 80 + 443。
DuckDNS 域名 / token / 局域网 IP	无	仅模式 3。
公网域名	无	仅模式 4，且必须已解析到这台服务器。
日志级别	info	trace / debug / info / warn / error。

数据库和会话密钥会自动生成，无需手动输入。它们写入 deploy/.env（文件权限 600，绝不会提交到 git）。

最后，让脚本启动堆栈：它会等待 API 就绪，创建你的管理员账号，并仅打印一次生成的密码，所以请在关闭终端前复制。

默认情况下，设置会从 Docker Hub 拉取预构建镜像：无需 Rust 或 Node 工具链，首次启动只需几分钟。运行 ./setup.sh --build 则改为从源码构建这三个服务（用于开发、本地修改）。

无界面服务器

管理员由 core 自身在首次启动时创建（根据 deploy/.env），因此服务器上不需要浏览器。记下打印出的密码，从任何能访问该应用的机器登录即可。

覆盖安装旧数据

如果存在上次安装遗留的 Docker 卷，设置会询问是否清除。所有提示的默认选项都是 No：只有明确输入 y 才会清除（并丢失之前的数据库）。新密钥无法配合旧的数据库卷使用，所以拒绝清除会中止设置，而不是启动一个有问题的堆栈。

手动安装（替代方式）

如果你更想手动配置：

cd deploy
cp .env.example .env

编辑 .env，至少设置：

• POSTGRES_PASSWORD：高强度密码
• DATABASE_URL：必须包含相同的密码，例如 postgres://otw:YOUR_PASSWORD@postgres:5432/opentraderworld
• SESSION_SECRET：一长串随机字符串

然后启动堆栈。默认会从 Docker Hub 拉取预构建镜像（无需 Rust 或 Node 工具链）：

docker compose -f docker-compose.yml -f docker-compose.images.yml \
  --env-file .env --env-file network.env up -d

改为从源码构建

用于开发或运行本地修改时，省略镜像覆盖文件，自行构建这三个服务（需要工具链；Rust 构建较慢）：

docker compose --env-file .env --env-file network.env up --build -d

创建管理员（仅限手动安装）

如果你使用了 ./setup.sh 并让它启动了堆栈，则管理员已存在，请跳过此步。

否则，在浏览器中打开应用（默认 http://localhost:5454）。首次访问时，OpenTraderWorld 会检测到尚无管理员，并显示设置向导：选择用户名和密码（至少 8 个字符），提交后进入dashboard。密码使用 argon2 哈希存储。

通过 CLI 创建管理员（无界面，无需浏览器）

从堆栈内部访问首次运行的端点：无论你的绑定接口或 TLS 模式如何都能使用，如果管理员已存在则会拒绝（HTTP 409）：

cd deploy
docker compose --env-file .env --env-file network.env exec -T caddy \
  wget -qO- --header=Content-Type:application/json \
  --post-data='{"username":"admin","password":"CHOOSE-A-STRONG-ONE"}' \
  http://core:8080/api/setup

验证是否在运行

• 应用：http://localhost:5454（或你选择的端口/域名）
• 健康检查：http://localhost:5454/api/health → {"status":"ok","service":"otw-core",...}

cd deploy
docker compose ps            # container status
docker compose logs -f core  # follow core logs

日常操作

在 deploy/ 中运行：

操作	命令
启动	docker compose up -d
停止	docker compose down
查看日志	docker compose logs -f
拉取较新的镜像	docker compose -f docker-compose.yml -f docker-compose.images.yml pull && docker compose up -d
修改代码后重新构建（源码构建）	docker compose up --build -d
停止并清除所有数据	docker compose down -v

你的数据保存在 Docker 命名卷中，在 up/down 之间持续保留。只有 down -v 才会删除它。

后续步骤

• 第一步：登录、设置默认值、安装模块。
• 网络与远程访问：从其他设备访问应用、局域网 HTTPS、公网暴露。
• 出问题了？参见故障排查。