快速上手

需要准备 Docker，以及一个容器可达的 PostgreSQL 数据库。镜像发布在 GHCR，覆盖 linux/amd64 与 linux/arm64：

docker run -d --name metaxisdata \
  -p 8083:8083 \
  -e PG_URL='postgres://user:password@db-host:5432/metaxisdata?sslmode=disable' \
  ghcr.io/ranxy/metaxisdata:latest

手头没有 Docker?每次 release 也会把同一个服务端以静态二进制发布到五个平台——从 GitHub Releases 下载后直接运行；部署指南的「获取服务端」一节给出了做法。

打开 http://<host>:8083，然后：

1. 创建第一个账号。 它会成为工作区管理员。
2. 添加一个实例并同步它的 schema。

后续步骤（可选）：

• 关闭自助注册。 在 设置 → 通用设置 中开启「禁止自助注册」，此后只有管理员能创建用户。
• 启用 HTTPS。 容器按设计只提供明文 HTTP。请在它前面用反向代理终止 HTTPS，并把 METAXISDATA_TRUSTED_PROXIES 设为代理地址，让审计日志记录客户端而不是代理。
• 保护已存凭据。 设置 METAXISDATA_ENCRYPTION_KEY，这样仅凭一份数据库转储将无法解密平台为各实例保存的凭据——并妥善保管这把密钥：一旦丢失，已存的凭据将无法读取。
• 接入 MCP 客户端。 在 设置 → 通用设置 中启用 MCP 端点（需要先配置工作区外部地址），再参照 docs/mcp.md 配置客户端。

完整的部署指南——每个环境变量、健康检查与版本端点、预编译二进制，以及如何自行构建镜像或二进制——见 docs/deploy_zh.md。

docker-compose.yml 会把 PostgreSQL 和服务端一起启动，因此在你的机器上看一眼构建出来的镜像，只需要一条命令：

make docker-up      # 构建镜像，然后启动 PostgreSQL + 服务端，访问 http://localhost:8083
make docker-down    # 停止两者；compose 的数据卷会保留

打开 http://localhost:8083 并创建第一个账号。这个栈为「快速试一个构建产物」而生——端口对外发布、开发密码硬编码——并不是为生产环境准备的。细节与注意事项见 docs/local-trial_zh.md。