Update supplied README, public installation guide and five-phase roadmap
This commit is contained in:
1 parent
fd34fae8ef
commit
f17a6de63f
8 files changed
+325
-173
No files matched your search
+37
-26
@@ -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)
|
||||
Reference in new issue
Block a user