OPC 文档
  • 简体中文

    • 快速开始

    最短路径是 Docker。跑起来之后再回头看安装部署里的数据库与 反向代理选项。

    部署要求

    组件要求
    容器引擎Docker / Docker Compose
    数据库生产用 PostgreSQL ≥ 9.6；本地与测试可用 SQLite；MySQL ≥ 5.7.8 也被 ORM 支持
    系统架构仅 64 位（amd64 / arm64）

    Geekit 实际部署与运行的数据库是 PostgreSQL，这一点不会变。SQLite 与 MySQL 仍 被 ORM 支持，主要用于本地运行和测试。

    用 Docker Compose

    git clone https://github.com/yirenyiqi/geekit.git
cd geekit

# 按需修改数据库、端口、时区
nano docker-compose.yml

docker compose up -d

    用 docker run

    docker pull yirenyiqi/geekit:latest

docker run --name geekit -d --restart always \
  -p 8801:8801 \
  -e TZ=Asia/Shanghai \
  -v ${HOME}/.docker-volumn/geekit/geekit:/data \
  -v ${HOME}/.docker-volumn/geekit/sqlite:/sqlite \
  yirenyiqi/geekit:latest

    接远程数据库时加 SQL_DSN：

      -e SQL_DSN="postgres://geekit:PASSWORD@db-host:5432/geekit"

    /data 存运行数据，/sqlite 存 SQLite 数据库文件，分别挂到宿主机的独立目录。

    验证

    启动后访问 http://<主机>:8801。健康检查端点是 /api/status，返回 JSON 即为 正常：

    curl -s http://localhost:8801/api/status

    首次登录使用初始管理员账号，登录后立即改密码，再去后台配置上游渠道。

    升级

    拉新镜像重建容器即可。表结构与数据变更写在仓库的 migration/ 里，容器启动时 自动重放，不需要手工执行 SQL。

    docker pull yirenyiqi/geekit:latest
docker compose up -d
    不要在已部署环境里手改数据

    需要修正的持久化数据一律通过新增版本化变更来处理。直接改库不会传播到其他环境， 也无法评审。