[{"data":1,"prerenderedAt":194},["ShallowReactive",2],{"guide-doc-open-source-release-quickstart":3},{"id":4,"title":5,"audience":6,"body":7,"businessModel":183,"description":184,"extension":185,"meta":186,"navigation":187,"path":188,"seo":189,"status":190,"stem":191,"updatedAt":192,"__hash__":193},"content\u002Fguide\u002Fopen-source-release\u002Fquickstart.md","开源发行 \u002F 一键部署快速开始","community-user",{"type":8,"value":9,"toc":172},"minimark",[10,15,44,47,59,63,94,97,108,111,129,132,156,159],[11,12,14],"h2",{"id":13},"_20-分钟清单","20 分钟清单",[16,17,18,27,34,41],"ol",{},[19,20,21,22,26],"li",{},"下载 ",[23,24,25],"code",{},"release\u002Fcommunity"," 发行包。",[19,28,29,30,33],{},"配置 ",[23,31,32],{},".env"," 并执行安装脚本。",[19,35,36,37,40],{},"访问 ",[23,38,39],{},"\u002Factuator\u002Fhealth"," 检查服务状态。",[19,42,43],{},"打开后台完成初始化账号设置。",[11,45,46],{"id":46},"前置条件",[48,49,50,53,56],"ul",{},[19,51,52],{},"已准备可用服务器或 Docker 运行环境。",[19,54,55],{},"已下载完整发行包并校验文件完整性。",[19,57,58],{},"已准备数据库、Redis 连接参数。",[11,60,62],{"id":61},"详细步骤可直接执行","详细步骤（可直接执行）",[16,64,65,75,78,89],{},[19,66,67,68,71,72,74],{},"解压发行包并复制 ",[23,69,70],{},".env.example"," 为 ",[23,73,32],{},"。",[19,76,77],{},"按环境填写数据库、Redis、端口等配置。",[19,79,80,81,84,85,88],{},"执行 ",[23,82,83],{},"install.sh"," 或 ",[23,86,87],{},"bt-install.sh"," 完成部署。",[19,90,36,91,93],{},[23,92,39],{}," 和后台登录页完成首轮验证。",[11,95,96],{"id":96},"预期结果",[48,98,99,102,105],{},[19,100,101],{},"5 分钟内可完成首次部署启动。",[19,103,104],{},"安装脚本可重复执行且不破坏环境。",[19,106,107],{},"管理后台可正常登录并进行基础配置。",[11,109,110],{"id":110},"失败回滚",[48,112,113,120,123],{},[19,114,115,116,119],{},"安装失败：执行 ",[23,117,118],{},"rollback.sh"," 恢复安装前状态。",[19,121,122],{},"升级失败：回滚到上一发行包版本并恢复配置。",[19,124,125,126,128],{},"配置错误：恢复 ",[23,127,32],{}," 备份后重新执行安装。",[11,130,131],{"id":131},"常见报错与处理",[48,133,134,144,150],{},[19,135,136,139,140,143],{},[23,137,138],{},"端口占用","：修改 ",[23,141,142],{},"APP_PORT"," 并重启服务。",[19,145,146,149],{},[23,147,148],{},"数据库初始化失败","：检查账号权限和库字符集。",[19,151,152,155],{},[23,153,154],{},"健康检查失败","：查看应用日志定位启动异常。",[11,157,158],{"id":158},"提单时请提供",[48,160,161,164,169],{},[19,162,163],{},"操作系统与部署方式（脚本\u002F宝塔\u002FDocker）。",[19,165,166,168],{},[23,167,32],{}," 脱敏配置与安装日志。",[19,170,171],{},"健康检查结果和错误截图。",{"title":173,"searchDepth":174,"depth":174,"links":175},"",2,[176,177,178,179,180,181,182],{"id":13,"depth":174,"text":14},{"id":46,"depth":174,"text":46},{"id":61,"depth":174,"text":62},{"id":96,"depth":174,"text":96},{"id":110,"depth":174,"text":110},{"id":131,"depth":174,"text":131},{"id":158,"depth":174,"text":158},"open-source-release","社区用户快速安装最短步骤","md",{},true,"\u002Fguide\u002Fopen-source-release\u002Fquickstart",{"title":5,"description":184},"active","guide\u002Fopen-source-release\u002Fquickstart","2026-05-31","qyc8cEnLTgtGf3W-JAwEnOc_nXhqTCWQF64NNBPF3dQ",1785828434051]