Update supplied README, public installation guide and five-phase roadmap

This commit is contained in:
VPSMaster Maintainer committed 2026-11-02 03:26:30 -08:00
1 parent fd34fae8ef
commit f17a6de63f
8 files changed
+325 -173

No files matched your search

+37 -26
View File
@@ -1,10 +1,39 @@
# 安装、更新与卸载 / Installation
需要 Linux、Python 3.10+ 和标准库 venv;Ubuntu 22.04+ 是主要目标。安装器不下载依赖、不调用 pip/sudo/系统包管理器。缺少 Python 或 venv 时明确退出,由用户自行选择系统依赖安装方式。
需要 Linux、Python 3.10+、标准库venv与Git。主要目标为Ubuntu22.04+。安装器不下载依赖,不调用pip、sudo或系统包管理器;缺少依赖时明确退出。
## ZIP 安装
## 从公开GitHub安装(推荐)
从可信的 [Releases](https://github.com/griffinmx/VPSMaster/releases) 渠道取得同一构建的 ZIP 与 `SHA256SUMS.txt`。校验只能验证内容一致性,不能独立证明发布者身份。私有测试期间需访问授权。
```bash
git clone https://github.com/griffinmx/VPSMaster.git
cd VPSMaster
python3 -I -B install.py --run
```
公开仓库克隆不需要GitHub登录。安装器检查根目录MANIFEST.sha256.json列出的文件与哈希,在用户目录创建不含pip的隔离环境。默认位置:`~/.local/share/vpsmaster/1.0.0b1/`。
`--run`安装后执行离线suite,不是联网all。看到Installed表示安装阶段完成;其后返回1可能表示体检发现问题或结果不完整,应分别查看输出。参数/完整性/安装失败通常返回2。不要跳过校验来解决文档与清单不一致问题。
```bash
~/.local/share/vpsmaster/1.0.0b1/bin/vpsmaster --version
~/.local/share/vpsmaster/1.0.0b1/bin/vpsmaster all --lang zh
~/.local/share/vpsmaster/1.0.0b1/bin/vpsmaster all --offline --lang en
```
联网默认300秒、每模块60秒。Server纯文字控制台中文需要字体支持,可以使用英文或支持中文的SSH终端。Git代理不会自动应用到所有诊断探测,下载成功不证明检测目标TCP/TLS可达。
## 新目录安装与重复安装
```bash
python3 -I -B install.py --prefix "$HOME/vpsmaster-beta-test" --run
"$HOME/vpsmaster-beta-test/bin/vpsmaster" all --lang en
```
目标必须事先不存在,重复安装拒绝覆盖,不会擅自删除旧目录。安装器会打印实际入口路径。测试首次安装时可使用独立HOME或显式prefix,不能覆盖已有安装。
## ZIP安装(仅在取得对应发行文件时)
从可信发行渠道取得同一构建ZIP和SHA256SUMS.txt;[Releases](https://github.com/griffinmx/VPSMaster/releases)中Draft只对有权限的协作者可见,不等于公开发行文件。
```bash
sha256sum -c SHA256SUMS.txt
@@ -13,30 +42,12 @@ cd VPSMaster-v1.0.0-beta.1
python3 -I -B install.py --run
```
默认目录为 `~/.local/share/vpsmaster/1.0.0b1`。`--run` 安装后运行离线 suite;检测有发现时可能返回 1,先查看安装器和检测各自的输出。
GitHub main的文档可能比旧Beta.1 ZIP更新,必须核对具体构建。校验和只验证内容一致性,不能独立证明发布者身份。
安装器检查根目录 `MANIFEST.sha256.json`,创建不含 pip 的隔离 venv,复制 Python 包并提供 `bin/vpsmaster` 与 `bin/proxydoctor`。不要自行移动清单中的文件。
## 更新、卸载与兼容
## 自定义目录与重复安装
更新时使用新源码目录和新的安装prefix,验证后再切换入口;旧报告不自动迁移。卸载前备份报告并核对安装路径,只删除自己确认的安装目录,不要删除整个~/.local/share。
```bash
python3 -I -B install.py --prefix "$HOME/vpsmaster-beta-test"
"$HOME/vpsmaster-beta-test/bin/vpsmaster" --version
```
vpsmaster与proxydoctor命令指向同一实现;内部Python包、JSON schema和PROXYDOCTOR_*环境变量保留。旧~/.local/share/proxydoctor/不自动迁移。源码运行仍支持`bash vpsmaster.sh ...`和`bash proxydoctor.sh ...`。
必须指定尚不存在的目录;重复安装拒绝覆盖。安装失败会清理本次新建的安装目录,保留既有安装。
## 更新和卸载
更新时先核对新包校验和,安装到新的目录并验证,再切换自己使用的启动器路径。没有自动更新、旧报告迁移或自动卸载。卸载前备份报告、核对实际安装路径,然后仅删除自己确认的安装目录;不要删除整个 `~/.local/share`。
## 源码运行与兼容
```bash
bash vpsmaster.sh check --lang zh
bash proxydoctor.sh check --lang en
```
内部 Python 包与发行元数据仍名为 `proxydoctor`;现有 JSON schema、`PROXYDOCTOR_*` 环境变量保留。没有新增 `VPSMASTER_*` 环境变量别名。旧 `~/.local/share/proxydoctor/` 不自动迁移。
[使用指南](USAGE.md) · [返回首页](../../README.md)
[使用指南](USAGE.md) · [首页](../../README.md)