Self-hosted · YiQiao 0.2.0

在自己的环境里运行忆桥

当前仅提供自托管版本,不提供可直接登录的在线工作台。数据、密钥和运行状态都保留在你的基础设施中。

LOCAL ENVIRONMENT 由你控制
运行方式
Docker Compose
工作台
localhost:3000
REST API
localhost:8888
默认网络
仅本机回环地址

Quick start

四步启动本地工作台

准备 Git、Docker Desktop,或安装了 Docker Compose v2 插件的 Docker Engine。首次启动还需要能够访问你选择的模型服务商。

  1. 01

    获取公开仓库源码

  2. 02

    运行初始化脚本生成本地密钥

  3. 03

    启动 API、工作台与存储服务

  4. 04

    在浏览器完成首次设置

git clone https://github.com/daizhongming/YiQiao.git
cd YiQiao
./scripts/init.sh
cd server
docker compose up -d

Operate with control

上线前需要确认的边界

01

密钥与备份

server/.env 视为密钥文件。备份持久卷时同时验证恢复流程,不要把未加密密钥提交到仓库。

02

升级

升级前阅读版本说明并完成备份,再拉取新版本与镜像。不要跳过数据库和图存储的兼容检查。

03

外部访问

默认端口仅绑定回环地址。远程访问应使用 TLS 反向代理或私有网络,不要直接暴露数据库服务。

Open source, self-hosted

从你能看见、备份和迁移的环境开始。