feat: add panel entry script
This commit is contained in:
117
README.md
117
README.md
@ -52,9 +52,20 @@ docker run --pull=always \
|
||||
|
||||
## 面板服一键启动方案
|
||||
|
||||
仓库根目录提供了 `start.sh`，适合“只能上传文件、编辑文件，然后点一个固定 shell 脚本启动”的面板服环境。
|
||||
仓库根目录提供了：
|
||||
|
||||
这个脚本现在**直接复用官方 `packwiz-installer-bootstrap` / `packwiz-installer`**，而不是自己手动管理模组列表。
|
||||
- `start.sh`：仓库内真正负责安装与启动服务端的主脚本
|
||||
- `panel-start.sh`：专门给面板服上传使用的薄入口脚本
|
||||
|
||||
推荐你在面板服里这样用：
|
||||
|
||||
1. 直接下载仓库里的 `panel-start.sh`
|
||||
2. 上传到面板
|
||||
3. 如果面板要求固定入口文件名是 `start.sh`，就把它重命名成 `start.sh`
|
||||
4. 按需要修改里面的变量
|
||||
5. 点击运行
|
||||
|
||||
`start.sh` 现在**直接复用官方 `packwiz-installer-bootstrap` / `packwiz-installer`**，而不是自己手动管理模组列表。
|
||||
|
||||
它会自动完成这些事情：
|
||||
|
||||
@ -62,21 +73,13 @@ docker run --pull=always \
|
||||
2. 读取该 pack 的 `pack.toml` 中的 Minecraft / Fabric 版本
|
||||
3. 下载并执行 Fabric 官方 installer，生成服务端启动 jar
|
||||
4. 下载并执行 `packwiz-installer-bootstrap`
|
||||
5. 用 `packwiz-installer --side server` 根据远程 `pack.toml` 自动同步当前服务端需要的模组
|
||||
5. 用 `packwiz-installer --side server` 根据远程或本地 `pack.toml` 自动同步当前服务端需要的模组
|
||||
6. 自动写入 `eula.txt`
|
||||
7. 最后启动服务端
|
||||
|
||||
这意味着以后仓库里新增更多目录，例如：
|
||||
## 方案一：上传整个仓库后直接运行
|
||||
|
||||
- `server-01-random-block`
|
||||
- `server-02-xxx`
|
||||
- `server-03-yyy`
|
||||
|
||||
都可以继续复用同一个启动脚本，只需要切换 `PT_SERVER` 即可。
|
||||
|
||||
## 方案一：你把整个仓库上传到面板服
|
||||
|
||||
上传后，最简单的执行方式就是：
|
||||
如果你的面板允许你上传整个仓库，那么直接运行：
|
||||
|
||||
```bash
|
||||
PT_SERVER="server-01-random-block" bash start.sh
|
||||
@ -96,50 +99,74 @@ PT_SERVER="server-01-random-block" PT_JAVA_ARGS="-Xms1G -Xmx1G" bash start.sh
|
||||
PT_SERVER="server-02-xxx" bash start.sh
|
||||
```
|
||||
|
||||
### 什么时候需要 `PT_REPO_URL / PT_REPO_REF`
|
||||
## 方案二：只下载并上传 `panel-start.sh`
|
||||
|
||||
如果你希望 `packwiz-installer` 始终以远程仓库中的 `pack.toml` 为准，而不是当前本地文件，也可以额外传：
|
||||
如果你只想下载一个脚本文件再上传到面板，那么请直接使用：
|
||||
|
||||
```bash
|
||||
PT_REPO_URL="https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack" \
|
||||
PT_REPO_REF="main" \
|
||||
PT_SERVER="server-01-random-block" \
|
||||
bash start.sh
|
||||
- 仓库文件：`panel-start.sh`
|
||||
|
||||
你上传后：
|
||||
|
||||
- 如果面板固定执行文件名就是 `start.sh`，请把 `panel-start.sh` 重命名为 `start.sh`
|
||||
- 然后编辑这几个变量：
|
||||
|
||||
```sh
|
||||
REPO_URL="https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack"
|
||||
REPO_REF="main"
|
||||
PT_SERVER="server-01-random-block"
|
||||
PT_JAVA_ARGS="-Xms1G -Xmx1G"
|
||||
```
|
||||
|
||||
## 方案二：面板服里只粘贴一个“远程拉取并运行”的脚本
|
||||
这个脚本会：
|
||||
|
||||
如果你的面板服不方便手动上传整个仓库，而是允许你在固定 `.sh` 入口里粘贴脚本，那么可以直接粘贴下面这段：
|
||||
1. 从 Gitea 下载整个仓库归档
|
||||
2. 解压到当前目录下的 `pt-minecraft-modpack/`
|
||||
3. 自动调用仓库里的 `start.sh`
|
||||
|
||||
```bash
|
||||
#!/usr/bin/env bash
|
||||
set -Eeuo pipefail
|
||||
### 直接下载链接
|
||||
|
||||
你可以直接下载这个文件：
|
||||
|
||||
- `panel-start.sh`：
|
||||
`https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack/raw/branch/main/panel-start.sh`
|
||||
|
||||
## 方案三：直接复制 `panel-start.sh` 内容到面板里
|
||||
|
||||
如果你的面板不能单独下载文件，但允许你粘贴脚本内容，也可以把下面这段直接保存成面板入口脚本：
|
||||
|
||||
> 注意：请确保保存为 **LF 换行**，不要是 Windows 的 CRLF。
|
||||
|
||||
```sh
|
||||
#!/bin/sh
|
||||
set -eu
|
||||
|
||||
REPO_URL="https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack"
|
||||
REPO_REF="main"
|
||||
PT_SERVER="server-01-random-block"
|
||||
INSTALL_DIR="$(pwd)/pt-minecraft-modpack"
|
||||
ARCHIVE_PATH="$(pwd)/pt-minecraft-modpack.tar.gz"
|
||||
TMP_DIR="$(pwd)/pt-minecraft-modpack.__tmp"
|
||||
PT_JAVA_ARGS="-Xms1G -Xmx1G"
|
||||
|
||||
rm -rf "$TMP_DIR"
|
||||
mkdir -p "$TMP_DIR"
|
||||
|
||||
if command -v curl >/dev/null 2>&1; then
|
||||
DOWNLOAD() { curl -fL --retry 3 --retry-delay 2 -o "$1" "$2"; }
|
||||
curl -fL --retry 3 --retry-delay 2 -o "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
|
||||
elif command -v wget >/dev/null 2>&1; then
|
||||
DOWNLOAD() { wget -O "$1" "$2"; }
|
||||
wget -O "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
|
||||
else
|
||||
echo "缺少 curl 或 wget" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
ARCHIVE_PATH="$INSTALL_DIR.tar.gz"
|
||||
TMP_DIR="$INSTALL_DIR.__tmp"
|
||||
rm -rf "$TMP_DIR"
|
||||
mkdir -p "$TMP_DIR"
|
||||
|
||||
DOWNLOAD "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
|
||||
tar -xzf "$ARCHIVE_PATH" -C "$TMP_DIR"
|
||||
|
||||
EXTRACTED_DIR="$(find "$TMP_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
|
||||
[ -n "$EXTRACTED_DIR" ] || { echo "解压失败" >&2; exit 1; }
|
||||
if [ -z "$EXTRACTED_DIR" ]; then
|
||||
echo "解压失败" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
rm -rf "$INSTALL_DIR"
|
||||
mv "$EXTRACTED_DIR" "$INSTALL_DIR"
|
||||
@ -150,27 +177,21 @@ PT_REPO_URL="$REPO_URL" \
|
||||
PT_REPO_REF="$REPO_REF" \
|
||||
PT_SERVER="$PT_SERVER" \
|
||||
PT_JAVA_ARGS="$PT_JAVA_ARGS" \
|
||||
bash start.sh
|
||||
bash ./start.sh
|
||||
```
|
||||
|
||||
### 这个远程脚本怎么改
|
||||
## 环境兼容性说明
|
||||
|
||||
你通常只需要改这几个变量：
|
||||
有些面板不是用 `bash start.sh`，而是直接用 `sh start.sh`。因此：
|
||||
|
||||
- `REPO_REF`：默认 `main`，也可以改成某个分支或 tag
|
||||
- `PT_SERVER`：你这次要开的服务端目录名
|
||||
- `INSTALL_DIR`：解压后的安装目录
|
||||
- `PT_JAVA_ARGS`：JVM 参数
|
||||
|
||||
例如切换到另一个服务端：
|
||||
|
||||
```bash
|
||||
PT_SERVER="server-02-xxx"
|
||||
```
|
||||
- 面板入口脚本建议使用 `panel-start.sh` 这种 `sh` 兼容的薄脚本
|
||||
- 仓库内真正运行 Minecraft 的脚本继续使用 `bash`
|
||||
- 如果你是从 Windows 编辑/复制脚本，请务必使用 **LF** 换行，不要用 **CRLF**
|
||||
|
||||
## 环境要求
|
||||
|
||||
- 必须有 `bash`
|
||||
- 面板入口脚本需要：`sh`
|
||||
- 仓库主脚本 `start.sh` 需要：`bash`
|
||||
- 必须有 `java`
|
||||
- 必须有 `curl` 或 `wget`
|
||||
- 远程拉取方案还需要 `tar`
|
||||
|
||||
64
panel-start.sh
Executable file
64
panel-start.sh
Executable file
@ -0,0 +1,64 @@
|
||||
#!/bin/sh
|
||||
set -eu
|
||||
|
||||
# 面板入口脚本：适合“面板固定执行 start.sh，但只能上传文件/编辑文件”的环境。
|
||||
# 用法：
|
||||
# 1. 下载本文件
|
||||
# 2. 上传到面板，并按需要重命名为面板要求的固定入口名（通常就是 start.sh）
|
||||
# 3. 修改下面几个变量
|
||||
# 4. 点击运行
|
||||
|
||||
REPO_URL="${REPO_URL:-https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack}"
|
||||
REPO_REF="${REPO_REF:-main}"
|
||||
PT_SERVER="${PT_SERVER:-server-01-random-block}"
|
||||
INSTALL_DIR="${INSTALL_DIR:-$(pwd)/pt-minecraft-modpack}"
|
||||
ARCHIVE_PATH="${ARCHIVE_PATH:-$(pwd)/pt-minecraft-modpack.tar.gz}"
|
||||
TMP_DIR="${TMP_DIR:-$(pwd)/pt-minecraft-modpack.__tmp}"
|
||||
PT_JAVA_ARGS="${PT_JAVA_ARGS:--Xms1G -Xmx1G}"
|
||||
|
||||
log() {
|
||||
printf '[panel-entry] %s\n' "$*"
|
||||
}
|
||||
|
||||
fail() {
|
||||
printf '[panel-entry] ERROR: %s\n' "$*" >&2
|
||||
exit 1
|
||||
}
|
||||
|
||||
need_cmd() {
|
||||
command -v "$1" >/dev/null 2>&1 || fail "缺少命令: $1"
|
||||
}
|
||||
|
||||
need_cmd sh
|
||||
need_cmd tar
|
||||
need_cmd find
|
||||
|
||||
rm -rf "$TMP_DIR"
|
||||
mkdir -p "$TMP_DIR"
|
||||
|
||||
log "下载仓库归档: $REPO_URL ($REPO_REF)"
|
||||
if command -v curl >/dev/null 2>&1; then
|
||||
curl -fL --retry 3 --retry-delay 2 -o "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
|
||||
elif command -v wget >/dev/null 2>&1; then
|
||||
wget -O "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
|
||||
else
|
||||
fail "缺少 curl 或 wget"
|
||||
fi
|
||||
|
||||
log "解压仓库归档"
|
||||
tar -xzf "$ARCHIVE_PATH" -C "$TMP_DIR"
|
||||
|
||||
EXTRACTED_DIR="$(find "$TMP_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
|
||||
[ -n "$EXTRACTED_DIR" ] || fail "解压失败"
|
||||
|
||||
rm -rf "$INSTALL_DIR"
|
||||
mv "$EXTRACTED_DIR" "$INSTALL_DIR"
|
||||
rm -rf "$TMP_DIR" "$ARCHIVE_PATH"
|
||||
|
||||
cd "$INSTALL_DIR"
|
||||
log "调用仓库内 start.sh"
|
||||
PT_REPO_URL="$REPO_URL" \
|
||||
PT_REPO_REF="$REPO_REF" \
|
||||
PT_SERVER="$PT_SERVER" \
|
||||
PT_JAVA_ARGS="$PT_JAVA_ARGS" \
|
||||
bash ./start.sh
|
||||
Reference in New Issue
Block a user