Palgo 自部署操作手册

文档版本： 1.1
更新日期： 2026-06-27
适用脚本： palgo.sh
适用系统： Debian / Ubuntu 及衍生发行版（x86_64）

一、手册说明

palgo.sh 是 Palgo 本地环境的交互式自部署工具，通过一系列中文提示，按需完成 Web 服务部署、客户端安装、桌面组件配置等操作。所有步骤均为可选，运行时逐项选择即可。

官方安装命令：

bash

bash <(curl -fSL https://static.medipath.com.cn/dp/palgo.sh)

1.1 功能一览

序号	功能	说明
1	Palgo 本地版（web）	下载 ZIP，备份并解压到 `web` 目录
2	用户中心本地版（web2）	下载 ZIP，备份并解压到 `web2` 目录
3	app-download 资源更新	同步上传客户端离线安装包及 manifest
4	上传客户端	安装单机版 / mpai 版 / SaaS 版
5	AI 辅助分析客户端	安装内部版或公开版
6	AI 报告助手	安装 AI 报告助手桌面客户端
7	肾脏分析系统-local	安装本地肾脏分析桌面应用（`.deb`）
8	Focus 扩展	GNOME 扩展，建议安装
9	延伸管理器	GNOME Extension Manager，建议安装
10	RustDesk	远程桌面客户端及服务器配置指引
11	Google Chrome	安装 Chrome 浏览器
12	默认书签	向 Chrome 写入 Palgo 分析系统与用户中心书签

1.2 建议安装说明

Focus 扩展：修复 Ubuntu GNOME 下多次打开文件选择框时，对话框无法置顶并获得焦点的 bug，使用 Palgo 及相关桌面客户端时建议安装。
延伸管理器（Extension Manager）：图形化管理 GNOME 扩展，便于确认 Focus 状态，建议安装。

若仅需安装 Medipath-K 及 Focus / 插件管理器，可使用精简安装命令：bash <(curl -fSL https://static.medipath.com.cn/dp/Medipath_K.sh)，详见 MEDIPATH_K_OPERATION_MANUAL.zh-CN.md。

1.3 典型部署顺序

首次部署建议按脚本提示顺序，依次确认：

Palgo 本地版（web）→ 2. 用户中心（web2）→ 3. app-download 资源 → 4. 上传客户端
（按需）AI 客户端 → 6. （按需）肾脏分析 → 7. Focus + 延伸管理器 → 8. （按需）RustDesk → 9. Chrome → 10. 默认书签

二、安装前准备

2.1 环境要求

操作系统：Debian 或 Ubuntu（需支持 apt / dpkg / systemctl）
处理器架构：x86_64（amd64）
权限：root 或具备 sudo 的普通用户
网络：可访问 Medipath 静态资源、相关存储服务、Google 下载源（安装 Chrome 时）
已部署 Caddy 反向代理（更新 web/web2 后可选择重启）
桌面环境（Focus 扩展）：GNOME 图形会话

2.2 建议提前安装的依赖

bash

sudo apt-get update
sudo apt-get install -y curl wget python3 unzip tar dpkg apt \
  gnome-shell gnome-shell-extension-prefs
sudo pip3 install pyyaml 2>/dev/null || sudo apt-get install -y python3-yaml

工具	用途
`curl` / `wget`	下载 ZIP、manifest、`.deb` 等
`unzip` / `tar`	解压 Web 包、创建备份
`python3` + `yaml`	解析 app-download manifest
`dpkg` / `apt-get`	安装桌面客户端
`systemctl`	重启 Caddy 服务
`gnome-extensions`	安装 Focus 扩展

2.3 安装方式

推荐：远程一键安装（无需手动下载脚本）：

bash

bash <(curl -fSL https://static.medipath.com.cn/dp/palgo.sh)

脚本会自动通过 curl 拉取最新版 palgo.sh 并执行。需要图形桌面安装 Focus 扩展时，请在本机桌面终端中运行上述命令。

备选：本地脚本文件

若已持有 palgo.sh 副本，也可本地执行：

bash

chmod +x palgo.sh
sudo ./palgo.sh

2.4 安装前检查清单

[ ] 可访问 https://static.medipath.com.cn（远程一键安装）
[ ] 已安装 curl（远程一键安装必需）
[ ] 目标目录可写（默认 /home）
[ ] Caddy 已配置并监听 Palgo 端口（默认 8090 / 8091）
[ ] 若安装 Focus：在本机图形桌面打开终端
[ ] 明确本次需要执行的步骤（可只选部分）

三、运行安装程序

在终端执行（推荐远程一键安装）：

bash

bash <(curl -fSL https://static.medipath.com.cn/dp/palgo.sh)

启动日志：

[时间戳] palgo 自部署工具启动

直接按 Enter 为默认 否（跳过）；输入 y 或 yes 为确认执行。子步骤中带 (Y/n) 的项，直接回车表示是（默认备份）。

四、分步操作说明

4.1 Palgo 本地版（仅 web）

主提示：

是否安装 palgo 本地版 (仅 web)? (y/N):

子步骤：

提示	默认值	说明
palgo 本地版 ZIP 文件地址	`https://static.medipath.com.cn/dp/web/palgo/web.zip`	支持 http(s) URL 或本地文件路径
解压的目标目录	`/home`	解压到 `<目标目录>/web`
是否在解压前备份 `<目标目录>/web`	Y（是）	备份至 `<目标目录>/palgo-backups/<时间戳>/web.tar.gz`
是否重新启动 caddy 服务	N	更新 Web 后建议选 `y`

结果： web 目录更新完成，Palgo 分析系统默认访问 http://<主机>:8090（以 Caddy 配置为准）。

4.2 用户中心本地版（仅 web2）

主提示：

是否安装用户中心本地版 (仅 web2)? (y/N):

子步骤：

提示	默认值	说明
用户中心 ZIP 文件地址	`https://static.medipath.com.cn/dp/web/user-center/web2.zip`	支持 URL 或本地路径
解压的目标目录	`/home`	解压到 `<目标目录>/web2`
是否在解压前备份 `<目标目录>/web2`	Y（是）	备份至 `palgo-backups` 目录
是否重新启动 caddy 服务	N	更新后建议选 `y`

结果： 用户中心默认访问 http://<主机>:8091。

4.3 更新 app-download 资源

主提示：

是否更新本地版上传客户端 app-download 资源? (y/N):

子步骤：

提示	默认值	说明
app-download 目标目录	`<目标目录>/web/app-download`	若已部署 web，通常为 `/home/web/app-download`

行为： 下载并保存以下 manifest 及关联安装包：

latest.yml
latest-mac.yml
latest-linux.yml

建议： 在安装上传客户端之前更新 app-download，上传客户端会优先使用本地缓存的 .deb。

4.4 上传客户端

主提示：

是否安装本地版上传客户端? (y/N):

版本选择：

请选择要安装的上传客户端版本:
1) selfhost (单机版)
2) mpaihost (mpai 版)
3) sasshost (SaaS版)
请输入选项 (1-3, 默认: 1):

选项	版本	适用场景
1	selfhost 单机版	本地单机部署（默认）
2	mpaihost	mpai 环境
3	sasshost	SaaS 环境

安装时若 app-download 目录已有对应 .deb，将优先使用本地包。

4.5 AI 辅助分析客户端

主提示：

是否安装 AI 辅助分析客户端? (y/N):

版本选择：

1) 内部版（包含测试服地址）
2) 公开版
请输入选项 (1-2, 默认: 2):

选项	说明
1	内部版，含测试服地址
2	公开生产版（默认）

4.6 AI 报告助手

主提示：

是否安装 AI 报告助手? (y/N):

无子选项，自动从远程 manifest 拉取最新 Linux 包并安装。

4.7 肾脏分析系统-local

主提示：

是否安装肾脏分析系统-local? (y/N):

行为： 下载远程 JSON 配置，解析 download.linux 字段，安装对应 .deb 包。与 Medipath_K.sh 安装的是同一产品线（本地肾脏分析桌面应用）。

4.8 Focus 扩展（建议安装）

主提示：

是否安装 Focus 扩展? (y/N):

用途： 修复 Ubuntu GNOME 下多次选文件时，系统文件选择框无法置顶并获得焦点的问题。建议安装。

要求：

需在 GNOME 图形桌面运行
使用 sudo 时扩展安装到 $SUDO_USER
扩展 UUID：steal-my-focus@kagesenshi.org

未生效时： 按 Alt+F2，输入 r 重启 GNOME Shell，或注销重登。

4.9 延伸管理器（建议安装）

主提示：

是否安装延伸管理器 (Extension Manager)? (y/N):

通过 apt 安装 gnome-shell-extension-manager，便于图形化管理 Focus 等扩展。建议安装。

4.10 RustDesk

主提示：

是否安装 RustDesk? (y/N):

安装完成后脚本会输出网络配置，请在 RustDesk 网络设置中填写：

配置项	值
ID 服务器	`git.medipath.com.cn`
中继服务器	`git.medipath.com.cn`
Key	`Gv4NLEOCdFe3n1b66xQG+yYfVcsZus3qRXCDs2HgcI0=`

4.11 Google Chrome

主提示：

是否安装 Google Chrome? (y/N):

子步骤：

提示	说明
是否改用备用地址	默认 Google 官方源；可选 Medipath 镜像
自定义 Chrome 下载 URL	留空则沿用当前地址

4.12 默认书签

主提示：

是否添加默认书签? (y/N):

行为： 向 Chrome 书签栏写入（若已存在同名书签则跳过）：

书签名称	URL
palgo分析系统	`http://0.0.0.0:8090`
palgo用户中心	`http://0.0.0.0:8091`

原有书签文件会先备份为 Bookmarks.bak.<时间戳>。

建议： 在安装 Chrome 之后执行本步骤。

4.13 完成

[时间戳] 所有操作完成

临时文件自动清理。

五、安装结果验证

5.1 Web 服务

bash

curl -I http://127.0.0.1:8090
curl -I http://127.0.0.1:8091
sudo systemctl status caddy

浏览器访问 Palgo 分析系统与用户中心页面。

5.2 app-download

bash

ls -lh /home/web/app-download/

确认 manifest 及 .deb / 安装包文件存在。

5.3 桌面客户端

bash

dpkg -l | grep -iE 'palgo|upload|medipath|kidney|rustdesk|chrome'

从应用菜单启动各客户端，确认可正常打开。

5.4 Focus 扩展

bash

gnome-extensions list --enabled | grep steal-my-focus

5.5 Chrome 书签

在 Chrome 书签栏确认 palgo分析系统 与 palgo用户中心 两项。

六、备份与回滚

6.1 自动备份

Web / web2 部署前默认备份至：

<目标目录>/palgo-backups/<YYYYMMDD-HHMMSS>/web.tar.gz
<目标目录>/palgo-backups/<YYYYMMDD-HHMMSS>/web2.tar.gz

6.2 手动回滚 Web

bash

sudo systemctl stop caddy
sudo rm -rf /home/web
sudo tar -xzf /home/palgo-backups/<时间戳>/web.tar.gz -C /home
sudo systemctl start caddy

web2 同理，将 web 替换为 web2。

七、常见问题

Q1：提示缺少必要命令

按第二节安装 curl、unzip、python3、python3-yaml 等依赖。

Q2：Caddy 重启失败

bash

sudo systemctl status caddy
sudo journalctl -u caddy -n 50

确认 Caddy 已安装且配置文件有效。

Q3：app-download 解析 manifest 失败

确认已安装 PyYAML：sudo apt-get install -y python3-yaml

Q4：上传客户端未使用本地包

先执行 4.3 app-download 资源更新，并确认 APP_DOWNLOAD_DIR 路径与 manifest 中文件名一致。

Q5：Focus 扩展安装失败

在本机图形桌面终端运行脚本，或手动执行：

bash

gnome-extensions install --force <zip路径>
gnome-extensions enable steal-my-focus@kagesenshi.org

Q6：Chrome 书签未出现

确认已安装 Chrome 且至少启动过一次
书签写入目标用户为 $SUDO_USER
重启 Chrome 后查看书签栏

Q7：`.deb` 安装依赖失败

bash

sudo apt-get update
sudo apt-get install -f -y

八、远程资源参考

资源	地址
Palgo 本地版 ZIP	`https://static.medipath.com.cn/dp/web/palgo/web.zip`
用户中心 ZIP	`https://static.medipath.com.cn/dp/web/user-center/web2.zip`
上传客户端 manifest（单机 Linux）	`https://static.medipath.com.cn/palgo-app/selfhost/latest-linux.yml`
AI 辅助分析（生产）	`https://static.medipath.com.cn/app/prod/medipath/latest-linux.yml`
AI 报告助手	`https://static.medipath.com.cn/app/ai-assistant/latest-linux.yml`
肾脏分析配置	`https://static-1301025454.cos.ap-shanghai.myqcloud.com/pathexpert/updater/current_local.json`
Focus 扩展	`https://static.medipath.com.cn/app/extensions/Steal%20My%20Focus429.zip`
RustDesk	`https://static.medipath.com.cn/dp/web/rustdesk-1.4.6-x86_64.deb`
Chrome 备用镜像	`https://static.medipath.com.cn/dp/web/google-chrome-stable_143.0.7499.192-1_amd64.deb`
安装脚本（远程）	`https://static.medipath.com.cn/dp/palgo.sh`

九、快速参考

bash

# 远程一键安装（推荐）
bash <(curl -fSL https://static.medipath.com.cn/dp/palgo.sh)

# 查看备份
ls -la /home/palgo-backups/

# 重启 Caddy
sudo systemctl restart caddy

# 验证 Focus 扩展
gnome-extensions list --enabled | grep steal-my-focus

十、相关文档

文档	说明
`PALGO_OPERATION_MANUAL.en.md`	英文版操作手册
`MEDIPATH_K_OPERATION_MANUAL.zh-CN.md`	Medipath-K 精简安装手册
`Medipath_K.sh`	仅 Medipath-K + Focus + 插件管理器
`palgo.sh`	本手册对应脚本

修订记录

版本	日期	说明
1.0	2026-06-27	初版，覆盖 `palgo.sh` 全部 12 项功能
1.1	2026-06-27	明确远程一键安装命令 `bash <(curl -fSL ...)`

Palgo 自部署操作手册 ​

一、手册说明 ​

1.1 功能一览 ​

1.2 建议安装说明 ​

1.3 典型部署顺序 ​

二、安装前准备 ​

2.1 环境要求 ​

2.2 建议提前安装的依赖 ​

2.3 安装方式 ​

2.4 安装前检查清单 ​

三、运行安装程序 ​

四、分步操作说明 ​

4.1 Palgo 本地版（仅 web） ​

4.2 用户中心本地版（仅 web2） ​

4.3 更新 app-download 资源 ​

4.4 上传客户端 ​

4.5 AI 辅助分析客户端 ​

4.6 AI 报告助手 ​

4.7 肾脏分析系统-local ​

4.8 Focus 扩展（建议安装） ​

4.9 延伸管理器（建议安装） ​

4.10 RustDesk ​

4.11 Google Chrome ​

4.12 默认书签 ​

4.13 完成 ​

五、安装结果验证 ​

5.1 Web 服务 ​

5.2 app-download ​

5.3 桌面客户端 ​

5.4 Focus 扩展 ​

5.5 Chrome 书签 ​

六、备份与回滚 ​

6.1 自动备份 ​

6.2 手动回滚 Web ​

七、常见问题 ​

Q1：提示缺少必要命令 ​

Q2：Caddy 重启失败 ​

Q3：app-download 解析 manifest 失败 ​

Q4：上传客户端未使用本地包 ​

Q5：Focus 扩展安装失败 ​

Q6：Chrome 书签未出现 ​

Q7：.deb 安装依赖失败 ​

八、远程资源参考 ​

九、快速参考 ​

十、相关文档 ​

修订记录 ​

Palgo 自部署操作手册

一、手册说明

1.1 功能一览

1.2 建议安装说明

1.3 典型部署顺序

二、安装前准备

2.1 环境要求

2.2 建议提前安装的依赖

2.3 安装方式

2.4 安装前检查清单

三、运行安装程序

四、分步操作说明

4.1 Palgo 本地版（仅 web）

4.2 用户中心本地版（仅 web2）

4.3 更新 app-download 资源

4.4 上传客户端

4.5 AI 辅助分析客户端

4.6 AI 报告助手

4.7 肾脏分析系统-local

4.8 Focus 扩展（建议安装）

4.9 延伸管理器（建议安装）

4.10 RustDesk

4.11 Google Chrome

4.12 默认书签

4.13 完成

五、安装结果验证

5.1 Web 服务

5.2 app-download

5.3 桌面客户端

5.4 Focus 扩展

5.5 Chrome 书签

六、备份与回滚

6.1 自动备份

6.2 手动回滚 Web

七、常见问题

Q1：提示缺少必要命令

Q2：Caddy 重启失败

Q3：app-download 解析 manifest 失败

Q4：上传客户端未使用本地包

Q5：Focus 扩展安装失败

Q6：Chrome 书签未出现

Q7：`.deb` 安装依赖失败

八、远程资源参考

九、快速参考

十、相关文档

修订记录