YYC³ 开发者文档 · 08-deployment

08 · 部署

本地生产（默认形态）

bun run build          # Turbopack 构建 + 全类型检查
bun run start          # Node 进程监听 :1228

数据落盘 data/yyc3.db（进程外文件，重启不丢）。多实例部署时注意：SQLite 单写者，多副本需共享挂载该目录或改用 PostgreSQL（接口已抽象）。

环境变量清单

变量 必填 默认 说明
BIGMODEL_API_KEY ✅ — BigModel 服务端密钥
PORT 1228（脚本内置） 监听端口
DATABASE_URL <cwd>/data/yyc3.db SQLite 库文件路径
NEXT_PUBLIC_AI_API_URL https://api.0379.love/v1 客户端 AI 网关（只读）
NEXT_PUBLIC_APP_URL http://localhost:1228 站点地址

脚本（scripts/）

脚本 用途
deploy-docker.sh / docker-compose 相关 容器化部署（注意：Dockerfile 需 node:≥22.13 基础镜像）
deploy-to-production.sh / deploy-to-yyc3-33.sh 历史部署目标
database-schema.sql 表结构 SQL 独立副本
auto-fix-errors.ts / generate-docs.py 历史维护工具/文档生成器

备份与恢复

# 在线安全备份（VACUUM INTO，不锁写）
# 代码内：getDatabase().backup("./backups/snapshot-$(date +%F).db")

# 恢复：停服后用备份文件替换 data/yyc3.db

健康检查清单（上线前）

运行时约束