feat(honcho): add honcho self-hosted deployment stack

2026-06-19 14:49:22 +08:00
parent 7a660e0482
commit 48b52ca21c
3 changed files with 574 additions and 1 deletions
@@ -0,0 +1,67 @@
+# ============================================================
+# Honcho Self-Hosted 部署 — 公共环境变量（不含敏感信息）
+# 复制为 env.cfg 后填入真实值，env.cfg 已被 .gitignore 忽略
+# ============================================================
+
+# ============================================================
+# 镜像版本
+# ============================================================
+# Honcho 主仓库 git ref（源码 build 用，可填 tag / branch / SHA）
+HONCHO_VERSION=main
+# PostgreSQL 大版本号（pgvector 镜像 tag 后缀，必须与镜像仓库支持的 tag 对应）
+HONCHO_DB_VERSION=18
+# Redis 大版本号
+HONCHO_REDIS_VERSION=8
+
+# 镜像仓库（默认公共镜像；自建私有 hub 可改 hub.tp229.com:3500/...）
+HONCHO_DB_IMAGE=pgvector/pgvector
+HONCHO_REDIS_IMAGE=redis
+
+# ============================================================
+# PostgreSQL 数据库
+# ============================================================
+HONCHO_DB_USER=honcho
+HONCHO_DB_NAME=honcho
+# scram-sha-256 比 md5 安全；与 POSTGRES_INITDB_ARGS --auth-host 同步
+POSTGRES_HOST_AUTH_METHOD=scram-sha-256
+
+# ============================================================
+# 宿主机数据卷路径（必须 WSL/Linux ext4 原生 fs，不能放 /mnt/9P）
+# 9P drvfs 的 fsync 不可靠，会导致 PG 数据损坏
+# ============================================================
+Volumes_Path=/data/Volumes/honcho
+
+# ============================================================
+# 服务端口（宿主机:容器，全部绑定 0.0.0.0 供 LAN 访问）
+# 5432 与 hindsight/dbSer 撞车，多服务共存时改 HONCHO_DB_PORT 区分
+# ============================================================
+HONCHO_API_PORT=8000
+HONCHO_DB_PORT=5432
+HONCHO_REDIS_PORT=6379
+
+# ============================================================
+# Honcho 应用配置
+# ============================================================
+HONCHO_LOG_LEVEL=INFO
+# 本地 LAN 自用可设 false；公网暴露必须改 true
+HONCHO_AUTH_USE_AUTH=false
+HONCHO_NAMESPACE=honcho
+# 关闭可省 embedding 费用（但失去语义检索能力）
+HONCHO_EMBED_MESSAGES=true
+HONCHO_EMBEDDING_MODEL=text-embedding-3-small
+# deriver 必须用支持 tool calling 的模型
+HONCHO_DERIVER_MODEL=gpt-5.4-mini
+HONCHO_DERIVER_WORKERS=1
+
+# ============================================================
+# LLM（OpenAI 兼容协议；可换 OpenRouter / vLLM / Ollama 等端点）
+# deriver 启动时强校验 API Key 非空，占位符会反复重启
+# ============================================================
+HONCHO_LLM_BASE_URL=https://api.openai.com/v1
+
+# ============================================================
+# 敏感值（必填，env.cfg 不提交）— 在 .gitignore 已忽略
+# ============================================================
+# HONCHO_LLM_API_KEY=<你的 OpenAI key 或兼容端点 key>
+# HONCHO_DB_PASSWORD=<强密码，不要带特殊字符，避免 URI 编码问题>
+# HONCHO_AUTH_JWT_SECRET=<仅 AUTH_USE_AUTH=true 时需要；用 python scripts/generate_jwt_secret.py 生成>