feat: add panel server start script

This commit is contained in:
2026-03-26 12:08:25 +08:00
parent 3a62a45283
commit ee01c3891d
2 changed files with 324 additions and 0 deletions

View File

@ -50,3 +50,55 @@ docker run --pull=always \
或者,需要从 [https://github.com/packwiz/packwiz-installer/releases](这里) 下载最新最热的 Installer以安装需要的文件。
## 面板服一键启动脚本
仓库根目录新增了 `start.sh`,适合“只能上传文件、编辑文件,然后点一个固定 shell 脚本启动”的面板服环境。
它会自动完成这些事情:
1. 读取 `server-01-random-block/pack.toml` 中的 Minecraft / Fabric 版本
2. 下载并执行 Fabric 官方 installer生成服务端启动 jar
3. 读取 `server-01-random-block/mods/*.pw.toml`
4. 自动下载服务端需要的模组到根目录 `mods/`
5. 自动写入 `eula.txt`
6. 最后启动服务端
### 最简单的用法
把整个仓库内容上传到服务器根目录后,直接让面板运行:
```bash
bash start.sh
```
### 环境要求
- 必须有 `bash`
- 必须有 `java`
- 必须有 `curl``wget`
- 建议有常见基础命令:`grep``sed``awk``find`
- 服务器需要能联网下载 Fabric installer 和 Modrinth 模组文件
### 可选环境变量
- `PT_JAVA_ARGS`Java 内存等参数,默认 `-Xms1G -Xmx2G`
- `PT_AUTO_EULA`:默认 `TRUE`,自动写入 `eula=true`
- `PT_FORCE_UPDATE=1`:强制重新安装 Fabric / 重新下载模组
- `PT_SERVER_JAR`:手动指定启动的服务端 jar 路径
- `PT_PACK_DIR`:手动指定 pack 目录,默认 `server-01-random-block`
- `PT_MODS_DIR`:手动指定模组目录,默认根目录下的 `mods/`
- `PT_RUNTIME_DIR`:缓存下载内容的目录,默认 `.pt-panel-runtime/`
- `PT_SKIP_HASH_CHECK=1`:跳过模组 hash 校验(不建议)
### 示例
```bash
PT_JAVA_ARGS="-Xms2G -Xmx4G" bash start.sh
```
如果面板要求固定脚本名,你也可以直接把 `start.sh` 重命名成面板要求的名字,或者让那个固定入口脚本只写一行:
```bash
bash start.sh
```