Palgo Self-Deployment Operation Manual

Document Version: 1.1
Last Updated: 2026-06-27
Script: palgo.sh
Target Platform: Debian / Ubuntu and derivatives (x86_64)

1. About This Manual

palgo.sh is an interactive self-deployment tool for Palgo local environments. It presents a series of Chinese prompts to optionally deploy web services, install desktop clients, and configure workstation components. Every step is optional — select only what you need at runtime.

Official install command:

bash

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

Note: Installer prompts and log messages are in Chinese. This manual provides English translations and operational guidance.

1.1 Feature Overview

#	Feature	Description
1	Palgo local (web)	Download ZIP, backup and extract to `web` directory
2	User center local (web2)	Download ZIP, backup and extract to `web2` directory
3	app-download resource update	Sync offline upload-client packages and manifests
4	Upload client	Install selfhost / mpaihost / sasshost edition
5	AI analysis assistant	Install internal or public edition
6	AI report assistant	Install AI report assistant desktop client
7	Kidney Analysis (local)	Install local kidney analysis desktop app (`.deb`)
8	Focus extension	GNOME extension, recommended
9	Extension Manager	GNOME Shell Extension Manager, recommended
10	RustDesk	Remote desktop client with server configuration
11	Google Chrome	Install Chrome browser
12	Default bookmarks	Write Palgo and user-center bookmarks to Chrome

1.2 Installation Recommendations

Focus extension: Fixes an Ubuntu GNOME bug where the system file picker fails to stay on top when selecting files multiple times. Recommended when using Palgo and related desktop clients.
Extension Manager: Graphical GNOME extension administration; recommended alongside Focus.

For Medipath-K only: bash <(curl -fSL https://static.medipath.com.cn/dp/Medipath_K.sh) — see MEDIPATH_K_OPERATION_MANUAL.en.md.

1.3 Typical First-Time Deployment Order

Follow the script prompts in order:

Palgo local (web) → 2. User center (web2) → 3. app-download resources → 4. Upload client
(Optional) AI clients → 6. (Optional) Kidney Analysis → 7. Focus + Extension Manager → 8. (Optional) RustDesk → 9. Chrome → 10. Default bookmarks

2. Before You Begin

2.1 Requirements

OS: Debian or Ubuntu (apt, dpkg, systemctl)
Architecture: x86_64 (amd64)
Privileges: root or user with sudo
Network: Medipath static hosts, related storage services, Google (for Chrome)
Caddy reverse proxy deployed (optional restart after web updates)
Desktop (Focus): GNOME graphical session

2.2 Recommended Dependencies

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

Tool	Purpose
`curl` / `wget`	Download ZIP, manifests, `.deb` files
`unzip` / `tar`	Extract web packages, create backups
`python3` + `yaml`	Parse app-download manifests
`dpkg` / `apt-get`	Install desktop clients
`systemctl`	Restart Caddy
`gnome-extensions`	Install Focus extension

2.3 Installation Methods

Recommended: remote one-liner (no manual download):

bash

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

This fetches the latest palgo.sh from Medipath static resources and runs it immediately. For Focus extension setup, run the command from a local graphical desktop terminal.

Alternative: local script file

If you already have a copy of palgo.sh:

bash

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

2.4 Pre-Installation Checklist

[ ] https://static.medipath.com.cn is reachable (for remote one-liner)
[ ] curl is installed (required for remote one-liner)
[ ] Target directory writable (default /home)
[ ] Caddy configured for Palgo ports (default 8090 / 8091)
[ ] For Focus: terminal opened on local graphical desktop
[ ] Planned steps identified (partial runs are supported)

3. Run the Installer

Execute in a terminal (recommended remote one-liner):

bash

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

Startup log:

[timestamp] palgo 自部署工具启动

Press Enter for default No (skip). Type y or yes to confirm. Sub-prompts marked (Y/n) default to Yes when you press Enter (e.g. backup before extract).

4. Step-by-Step Instructions

4.1 Palgo Local Edition (web only)

Main prompt (Chinese):

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

Translation: Install Palgo local edition (web only)? (y/N)

Sub-prompts:

Chinese prompt	Default	Description
请输入 palgo 本地版 ZIP 文件地址	`https://static.medipath.com.cn/dp/web/palgo/web.zip`	HTTP(S) URL or local file path
请输入解压的目标目录	`/home`	Extracts to `<target>/web`
是否在解压前备份 `<target>/web`	Y (yes)	Backup to `<target>/palgo-backups/<timestamp>/web.tar.gz`
是否重新启动 caddy 服务	N	Choose `y` after web update

Result: web directory updated. Palgo analysis system typically at http://<host>:8090 (per Caddy config).

4.2 User Center Local Edition (web2 only)

Main prompt:

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

Translation: Install user center local edition (web2 only)? (y/N)

Sub-prompts: Same pattern as 4.1, using web2.zip default URL and web2 directory.

Default ZIP: https://static.medipath.com.cn/dp/web/user-center/web2.zip

Result: User center typically at http://<host>:8091.

4.3 Update app-download Resources

Main prompt:

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

Translation: Update local upload-client app-download resources? (y/N)

Sub-prompt:

Chinese prompt	Default
请输入 app-download 目标目录	`<target>/web/app-download` (e.g. `/home/web/app-download`)

Behavior: Downloads and saves manifests (latest.yml, latest-mac.yml, latest-linux.yml) and associated installer files.

Tip: Run this before installing the upload client; the client prefers cached local .deb files.

4.4 Upload Client

Main prompt:

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

Version selection:

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

Option	Edition	Use case
1	selfhost	Standalone local deployment (default)
2	mpaihost	mpai environment
3	sasshost	SaaS environment

Uses local .deb from app-download when available.

4.5 AI Analysis Assistant

Main prompt:

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

Version selection:

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

Option	Description
1	Internal build with test-server endpoints
2	Public production build (default)

4.6 AI Report Assistant

Main prompt:

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

Translation: Install AI report assistant? (y/N)

No sub-options; downloads latest Linux package from remote manifest.

4.7 Kidney Analysis (local)

Main prompt:

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

Translation: Install Kidney Analysis System (local)? (y/N)

Downloads remote JSON config, parses download.linux, installs .deb. Same product line as Medipath_K.sh / Medipath-K.

4.8 Focus Extension (Recommended)

Main prompt:

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

Translation: Install Focus extension? (y/N)

Purpose: Fixes Ubuntu GNOME file picker focus/stacking issue when opening the dialog multiple times. Recommended.

Requirements:

GNOME graphical session required
With sudo, installs for $SUDO_USER
UUID: steal-my-focus@kagesenshi.org

If not effective: Alt+F2 → r → Enter, or log out and back in.

4.9 Extension Manager (Recommended)

Main prompt:

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

Translation: Install Extension Manager? (y/N)

Installs gnome-shell-extension-manager via apt. Recommended for managing Focus and other extensions.

4.10 RustDesk

Main prompt:

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

After installation, configure in RustDesk Network settings:

Setting	Value
ID server	`git.medipath.com.cn`
Relay server	`git.medipath.com.cn`
Key	`Gv4NLEOCdFe3n1b66xQG+yYfVcsZus3qRXCDs2HgcI0=`

4.11 Google Chrome

Main prompt:

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

Sub-prompts:

Chinese prompt	Description
是否改用备用地址	Switch to Medipath mirror instead of Google default
如需自定义 Chrome 下载 URL	Custom URL; leave empty to keep current

4.12 Default Bookmarks

Main prompt:

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

Translation: Add default bookmarks? (y/N)

Writes to Chrome bookmark bar (skips if entries already exist):

Bookmark	URL
palgo分析系统 (Palgo Analysis)	`http://0.0.0.0:8090`
palgo用户中心 (Palgo User Center)	`http://0.0.0.0:8091`

Existing Bookmarks file backed up as Bookmarks.bak.<timestamp>.

Tip: Run after Chrome installation.

4.13 Completion

[timestamp] 所有操作完成

Translation: All operations completed. Temporary files cleaned up on exit.

5. Verify Installation

5.1 Web Services

bash

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

Open Palgo analysis and user center in a browser.

5.2 app-download

bash

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

Confirm manifests and installer files are present.

5.3 Desktop Clients

bash

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

Launch each client from the application menu.

5.4 Focus Extension

bash

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

5.5 Chrome Bookmarks

Confirm palgo分析系统 and palgo用户中心 in the Chrome bookmark bar.

6. Backup and Rollback

6.1 Automatic Backups

Before web/web2 deployment (default enabled):

<target>/palgo-backups/<YYYYMMDD-HHMMSS>/web.tar.gz
<target>/palgo-backups/<YYYYMMDD-HHMMSS>/web2.tar.gz

6.2 Manual Web Rollback

bash

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

Replace web with web2 for user center rollback.

7. Frequently Asked Questions

Q1: Missing required commands

Install dependencies from Section 2.2 (curl, unzip, python3-yaml, etc.).

Q2: Caddy restart fails

bash

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

Verify Caddy is installed and configuration is valid.

Q3: app-download manifest parse failure

bash

sudo apt-get install -y python3-yaml

Q4: Upload client did not use local package

Run Section 4.3 first and verify app-download path matches cached filenames.

Q5: Focus extension installation fails

Run from a desktop terminal, or install manually:

bash

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

Q6: Chrome bookmarks not visible

Chrome must be installed and launched at least once
Bookmarks target $SUDO_USER
Restart Chrome and check the bookmark bar

Q7: `.deb` dependency errors

bash

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

8. Remote Resources

Resource	URL
Palgo local ZIP	`https://static.medipath.com.cn/dp/web/palgo/web.zip`
User center ZIP	`https://static.medipath.com.cn/dp/web/user-center/web2.zip`
Upload client manifest (selfhost Linux)	`https://static.medipath.com.cn/palgo-app/selfhost/latest-linux.yml`
AI analysis (production)	`https://static.medipath.com.cn/app/prod/medipath/latest-linux.yml`
AI report assistant	`https://static.medipath.com.cn/app/ai-assistant/latest-linux.yml`
Kidney analysis config	`https://static-1301025454.cos.ap-shanghai.myqcloud.com/pathexpert/updater/current_local.json`
Focus extension	`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 mirror	`https://static.medipath.com.cn/dp/web/google-chrome-stable_143.0.7499.192-1_amd64.deb`
Installer script (remote)	`https://static.medipath.com.cn/dp/palgo.sh`

9. Quick Reference

bash

# Remote one-liner install (recommended)
bash <(curl -fSL https://static.medipath.com.cn/dp/palgo.sh)

# List backups
ls -la /home/palgo-backups/

# Restart Caddy
sudo systemctl restart caddy

# Verify Focus extension
gnome-extensions list --enabled | grep steal-my-focus

Document	Description
`PALGO_OPERATION_MANUAL.zh-CN.md`	Chinese operation manual
`MEDIPATH_K_OPERATION_MANUAL.en.md`	Medipath-K minimal installer manual
`Medipath_K.sh`	Medipath-K + Focus + Extension Manager only
`palgo.sh`	Script covered by this manual

Revision History

Version	Date	Changes
1.0	2026-06-27	Initial release covering all 12 `palgo.sh` features
1.1	2026-06-27	Documented remote one-liner: `bash <(curl -fSL ...)`

Palgo Self-Deployment Operation Manual ​

1. About This Manual ​

1.1 Feature Overview ​

1.2 Installation Recommendations ​

1.3 Typical First-Time Deployment Order ​

2. Before You Begin ​

2.1 Requirements ​

2.2 Recommended Dependencies ​

2.3 Installation Methods ​

2.4 Pre-Installation Checklist ​

3. Run the Installer ​

4. Step-by-Step Instructions ​

4.1 Palgo Local Edition (web only) ​

4.2 User Center Local Edition (web2 only) ​

4.3 Update app-download Resources ​

4.4 Upload Client ​

4.5 AI Analysis Assistant ​

4.6 AI Report Assistant ​

4.7 Kidney Analysis (local) ​

4.8 Focus Extension (Recommended) ​

4.9 Extension Manager (Recommended) ​

4.10 RustDesk ​

4.11 Google Chrome ​

4.12 Default Bookmarks ​

4.13 Completion ​

5. Verify Installation ​

5.1 Web Services ​

5.2 app-download ​

5.3 Desktop Clients ​

5.4 Focus Extension ​

5.5 Chrome Bookmarks ​

6. Backup and Rollback ​

6.1 Automatic Backups ​

6.2 Manual Web Rollback ​

7. Frequently Asked Questions ​

Q1: Missing required commands ​

Q2: Caddy restart fails ​

Q3: app-download manifest parse failure ​

Q4: Upload client did not use local package ​

Q5: Focus extension installation fails ​

Q6: Chrome bookmarks not visible ​

Q7: .deb dependency errors ​

8. Remote Resources ​

9. Quick Reference ​

10. Related Documents ​

Revision History ​

Palgo Self-Deployment Operation Manual

1. About This Manual

1.1 Feature Overview

1.2 Installation Recommendations

1.3 Typical First-Time Deployment Order

2. Before You Begin

2.1 Requirements

2.2 Recommended Dependencies

2.3 Installation Methods

2.4 Pre-Installation Checklist

3. Run the Installer

4. Step-by-Step Instructions

4.1 Palgo Local Edition (web only)

4.2 User Center Local Edition (web2 only)

4.3 Update app-download Resources

4.4 Upload Client

4.5 AI Analysis Assistant

4.6 AI Report Assistant

4.7 Kidney Analysis (local)

4.8 Focus Extension (Recommended)

4.9 Extension Manager (Recommended)

4.10 RustDesk

4.11 Google Chrome

4.12 Default Bookmarks

4.13 Completion

5. Verify Installation

5.1 Web Services

5.2 app-download

5.3 Desktop Clients

5.4 Focus Extension

5.5 Chrome Bookmarks

6. Backup and Rollback

6.1 Automatic Backups

6.2 Manual Web Rollback

7. Frequently Asked Questions

Q1: Missing required commands

Q2: Caddy restart fails

Q3: app-download manifest parse failure

Q4: Upload client did not use local package

Q5: Focus extension installation fails

Q6: Chrome bookmarks not visible

Q7: `.deb` dependency errors

8. Remote Resources

9. Quick Reference

10. Related Documents

Revision History