GithubBackup/BackupX
1
0
Fork 0
mirror of https://github.com/Awuqing/BackupX.git synced 2026-09-05 15:37:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

修复: #46 Agent 一键安装脚本在 Debian dash 下执行失败 (#48)

Browse Source 
* 修复: #46 Agent 一键安装脚本在 Debian dash 下执行失败

根因（多因素，任何一个都可能导致用户复现的 "sh: 2: Syntax error: newline unexpected"）：
- Debian/Ubuntu 默认 /bin/sh → dash；pipe 方式下 shebang 被忽略
- Content-Type: text/x-shellscript 会触发部分 CDN/反向代理的脚本识别与改写
- 如果响应被改写为 HTML，sh 在第 2 行（<html>）即报此语法错误

修复：
1. 前端命令改为 `curl -fsSL URL | sudo bash`（避开 dash）
2. 命令面板增加"先下载再执行"备用命令（代理过滤场景兜底）
3. install handler Content-Type 改为 text/plain；加 nosniff / no-store /
   Content-Disposition 三头，减少中间层改写的概率
4. 脚本模板加 magic marker `BACKUPX_AGENT_INSTALL_V1`，用户可通过
   `head -3` 自查响应完整性；加 bash 自举段，文件执行时优先切到 bash

测试：
- installscript/issue46_test.go 断言 magic + bash-bootstrap 存在于三种模式
- install_flow_test.go 断言新 headers 与 marker
- go test ./... 全绿，前端 build 通过

* 修复: #46 用户截图证实 nginx SPA fallback 返回 index.html

用户反馈截图显示 curl 下载到的是 BackupX 前端 HTML，而非 shell 脚本——
说明 /install/:token 未被反向代理转发到后端，nginx 按 try_files fallback
到 /index.html，sh 读第 2 行 <html> 报语法错误。

真正的根因修复：
1. 后端 install 端点额外暴露 /api/install/:token 别名，让反向代理
   已有的 /api/ 转发规则自动接管
2. 节点创建时返回的 url/composeUrl 统一使用 /api/install/ 前缀
3. 更新 deploy/nginx.conf 模板：
   - 新增 location /install/ 转发（兼容旧版本生成的命令）
   - 新增 /health /ready /metrics 单独转发，避免 SPA fallback

测试：
- install_flow_test.go 新增 TestInstallScriptAliasUnderAPI 断言
  /api/install/:token 路径可用 + 新生成的 url 用 /api/install/ 前缀
This commit is contained in:
Wu Qing
2026-04-20 23:35:39 +08:00
committed by GitHub
parent 5021fe665e
commit e2baa6bd17
9 changed files with 191 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
server/internal/http/router.go
+9 -1
View File
@@ -320,7 +320,13 @@ func NewRouter(deps RouterDependencies) *gin.Engine {
engine.GET("/metrics", gin.WrapH(deps.Metrics.Handler()))
}
// 公开安装路由（不走 JWT 中间件）
// 公开安装路由（不走 JWT 中间件）。
// 同时注册到 / 和 /api 前缀下：
// - /install/:token 保留历史 URL，兼容旧 nginx 部署
// - /api/install/:token 新 URL，自动走反向代理的 /api/ 转发规则
//
// Issue #46：用户的 nginx 只转发 /api/，/install/* 被 SPA fallback 到 index.html，
// 返回 HTML 被 sh 解释成 "Syntax error"。使用 /api/install/ 可避开此问题。
if deps.InstallTokenService != nil {
gcCtx := deps.Context
if gcCtx == nil {
@@ -329,6 +335,8 @@ func NewRouter(deps RouterDependencies) *gin.Engine {
installHandler := NewInstallHandler(gcCtx, deps.InstallTokenService, deps.AuditService, deps.MasterExternalURL)
engine.GET("/install/:token", installHandler.Script)
engine.GET("/install/:token/compose.yml", installHandler.Compose)
engine.GET("/api/install/:token", installHandler.Script)
engine.GET("/api/install/:token/compose.yml", installHandler.Compose)
}
engine.NoRoute(func(c *gin.Context) {