Docker Compose 一条龙——服务器部署首选
Docker 是服务器部署的首选路径
桌面端适合本地个人使用，Docker Compose 适合服务器——一条命令把依赖都拉起来，端口 18080 直接开用。
三步启动
- 克隆仓库并进入：
- 复制环境变量模板，编辑
.env填入必填项： - 启动
``docker compose up -d``
Docker Compose 会拉起三个容器：
- mateclaw-server：Spring Boot 后端，端口 18080
- postgres：PostgreSQL 16，默认数据持久化在
./data/postgres - searxng：搜索工具后端，供内置搜索工具使用
.env 里必须填的
三个密码/密钥必须设置，否则启动失败：
| 变量 | 用途 |
|---|---|
| DB_PASSWORD | PostgreSQL 数据库密码 |
| DB_ADMIN_PASSWORD | 数据库 admin 用户密码 |
| JWT_SECRET | JWT 签名密钥，至少 32 字符 |
可选但推荐提前设的：DASHSCOPE_API_KEY——不想每次启动后去 UI 里粘 DashScope key 的话，提前放这里。
常见问题排查
后端起不来、日志里报 PostgreSQL 连接失败——等 PostgreSQL 就绪再说。容器启动有先后顺序，MateClaw 会在 PostgreSQL 准备好后自动连上。
对外端口 18080 被占用——改 docker-compose.yml 里 MateClaw 的端口映射。
想看日志：docker compose logs mateclaw-server 或 docker compose logs postgres。
升级流程
拉新版本代码、重新 compose up -d 就行。Flyway 管理的 schema 迁移会自动跑——旧版本到新版本的表结构变更。升级前建议先备份 PostgreSQL 数据卷。