Merge pull request 'fix: preserve panel install directory' (#4) from pi-agent/pt-minecraft-modpack:fix/preserve-panel-install-dir into main

Reviewed-on: #4

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,78 @@ 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
+- 仓库文件：`panel-start.sh`
-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
+- 如果面板固定执行文件名就是 `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"
 ```
 
-## 方案二：面板服里只粘贴一个“远程拉取并运行”的脚本
+`panel-start.sh` 默认会额外下载 `packwiz-installer.jar`，并通过本地文件方式交给 bootstrap 使用，适合 GitHub API 受限（例如 403）的面板环境。
+另外，它不会在每次启动时删除整个 `INSTALL_DIR`；如果目录已存在，只会覆盖仓库脚本与 pack 文件，尽量保留你已经配置好的文件。
 
-如果你的面板服不方便手动上传整个仓库，而是允许你在固定 `.sh` 入口里粘贴脚本，那么可以直接粘贴下面这段：
+这个脚本会：
 
-```bash
+1. 从 Gitea 下载整个仓库归档
-#!/usr/bin/env bash
+2. 解压到当前目录下的 `pt-minecraft-modpack/`
-set -Eeuo pipefail
+3. 额外下载 `packwiz-installer.jar`
+4. 自动调用仓库里的 `start.sh`
+
+### 直接下载链接
+
+你可以直接下载这个文件：
+
+- `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 +181,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
+- 面板入口脚本建议使用 `panel-start.sh` 这种 `sh` 兼容的薄脚本
-- `PT_SERVER`：你这次要开的服务端目录名
+- 仓库内真正运行 Minecraft 的脚本继续使用 `bash`
-- `INSTALL_DIR`：解压后的安装目录
+- 如果你是从 Windows 编辑/复制脚本，请务必使用 **LF** 换行，不要用 **CRLF**
-- `PT_JAVA_ARGS`：JVM 参数
-
-例如切换到另一个服务端：
-
-```bash
-PT_SERVER="server-02-xxx"
-```
 
 ## 环境要求
 
-- 必须有 `bash`
+- 面板入口脚本需要：`sh`
+- 仓库主脚本 `start.sh` 需要：`bash`
 - 必须有 `java`
 - 必须有 `curl` 或 `wget`
 - 远程拉取方案还需要 `tar`
@@ -194,6 +219,7 @@ PT_SERVER="server-02-xxx"
 - `PT_SERVER_JAR`：手动指定启动的服务端 jar 路径
 - `PT_RUNTIME_DIR`：缓存下载内容与状态文件的目录，默认 `.pt-panel-runtime/`
 - `PT_PACKWIZ_BOOTSTRAP_NO_UPDATE=1`：禁用 bootstrap 自更新
+- `PT_PACKWIZ_BOOTSTRAP_MAIN_JAR`：手动指定本地 `packwiz-installer.jar` 路径（适合 GitHub API 受限环境）
 - `PT_FABRIC_INSTALLER_VERSION`：手动指定 Fabric installer 版本
 - `PT_PACKWIZ_BOOTSTRAP_URL`：手动指定 bootstrap 下载地址
 

panel-start.sh

@@ -0,0 +1,83 @@
+#!/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}"
+PACKWIZ_INSTALLER_URL="${PACKWIZ_INSTALLER_URL:-https://github.com/packwiz/packwiz-installer/releases/latest/download/packwiz-installer.jar}"
+
+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 "解压失败"
+
+if [ ! -d "$INSTALL_DIR" ]; then
+  mv "$EXTRACTED_DIR" "$INSTALL_DIR"
+else
+  log "保留现有安装目录，仅覆盖仓库文件"
+  cp -r "$EXTRACTED_DIR"/. "$INSTALL_DIR"/
+  rm -rf "$EXTRACTED_DIR"
+fi
+rm -rf "$TMP_DIR" "$ARCHIVE_PATH"
+
+cd "$INSTALL_DIR"
+mkdir -p .pt-panel-runtime/downloads
+
+log "下载 packwiz-installer"
+if command -v curl >/dev/null 2>&1; then
+  curl -fL --retry 3 --retry-delay 2 -o .pt-panel-runtime/downloads/packwiz-installer.jar "$PACKWIZ_INSTALLER_URL"
+elif command -v wget >/dev/null 2>&1; then
+  wget -O .pt-panel-runtime/downloads/packwiz-installer.jar "$PACKWIZ_INSTALLER_URL"
+else
+  fail "缺少 curl 或 wget"
+fi
+
+log "调用仓库内 start.sh"
+PT_REPO_URL="$REPO_URL" \
+PT_REPO_REF="$REPO_REF" \
+PT_SERVER="$PT_SERVER" \
+PT_JAVA_ARGS="$PT_JAVA_ARGS" \
+PT_PACKWIZ_BOOTSTRAP_NO_UPDATE="${PT_PACKWIZ_BOOTSTRAP_NO_UPDATE:-1}" \
+PT_PACKWIZ_BOOTSTRAP_MAIN_JAR="$(pwd)/.pt-panel-runtime/downloads/packwiz-installer.jar" \
+bash ./start.sh

start.sh

@@ -18,6 +18,7 @@ AUTO_EULA="${PT_AUTO_EULA:-TRUE}"
 PACKWIZ_BOOTSTRAP_NO_UPDATE="${PT_PACKWIZ_BOOTSTRAP_NO_UPDATE:-0}"
 FABRIC_INSTALLER_VERSION="${PT_FABRIC_INSTALLER_VERSION:-}"
 PACKWIZ_BOOTSTRAP_URL="${PT_PACKWIZ_BOOTSTRAP_URL:-https://github.com/packwiz/packwiz-installer-bootstrap/releases/latest/download/packwiz-installer-bootstrap.jar}"
+PACKWIZ_BOOTSTRAP_MAIN_JAR="${PT_PACKWIZ_BOOTSTRAP_MAIN_JAR:-}"
 
 PACK_DIR=""
 PACK_URL=""
@@ -198,7 +199,11 @@ install_fabric_server() {
 run_packwiz_installer() {
   local args=( -jar "$BOOTSTRAP_JAR" -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
 
-  if [ "$PACKWIZ_BOOTSTRAP_NO_UPDATE" = "1" ]; then
+  if [ -n "$PACKWIZ_BOOTSTRAP_MAIN_JAR" ] && [ "$PACKWIZ_BOOTSTRAP_NO_UPDATE" = "1" ]; then
+    args=( -jar "$BOOTSTRAP_JAR" --bootstrap-no-update --bootstrap-main-jar "$PACKWIZ_BOOTSTRAP_MAIN_JAR" -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
+  elif [ -n "$PACKWIZ_BOOTSTRAP_MAIN_JAR" ]; then
+    args=( -jar "$BOOTSTRAP_JAR" --bootstrap-main-jar "$PACKWIZ_BOOTSTRAP_MAIN_JAR" -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
+  elif [ "$PACKWIZ_BOOTSTRAP_NO_UPDATE" = "1" ]; then
     args=( -jar "$BOOTSTRAP_JAR" --bootstrap-no-update -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
   fi