安装与运行

面向客户的推荐方式

项目提供按架构打包的 juzhenpan_docker_linux_*.zip。解压后运行安装脚本：

chmod +x install.sh backup.sh restore.sh
./install.sh

脚本会生成数据库密码、JWT 密钥和初始管理员密码。默认访问地址为 http://服务器IP:8080，后台入口为 /admin/login。生产环境应在 Caddy、Nginx 或宝塔中配置域名与 HTTPS 反向代理。

源码开发运行

当前仓库根目录的 Compose 文件说明了两种本地依赖组合：

# 启动 Elasticsearch 与 Redis，并使用已有外部 MySQL
docker compose --profile local-mw up -d --build

# 连同本地 MySQL 一起启动
docker compose --profile local-mysql up -d --build

如本机已有依赖，也可以直接构建 Go 服务：

go build -o bin/server ./cmd/server
./bin/server

前台不是单独的 Node.js 应用。HTML、CSS、JavaScript 和数据库初始结构会随 Go 程序交付；源码中的 *.part.js 由 ui/embed.go 按固定顺序组装为浏览器访问的脚本。

关键运行配置

纯二进制部署时，从 config.example.yml 复制为 config.yml。至少确认以下内容：

• MySQL 地址、端口、库名、用户和密码；
• Elasticsearch URL 与 Redis 地址；
• SITE_URL 与实际访问域名一致；
• 首次管理员信息已安全保存；
• security.jwt_secret 可留空，让首次启动生成 data/jwt-secret；
• 如开放接口，单独设置 OPEN_TOKEN，不要复用管理员凭据。

启动后的检查

1. 请求 /healthz，应得到表示服务正常的 JSON。
2. 打开首页，确认静态文件与公开配置可加载。
3. 打开 /admin/login，使用安装时生成的管理员凭据登录。
4. 在后台检查存储、Elasticsearch 和 Redis 相关功能。
5. 配置反向代理后再次检查 SITE_URL、HTTPS 和回调地址。

不要把 .env、config.yml、数据库密码、JWT 密钥或开放接口令牌提交到版本库，也不要出现在帮助文档截图中。