feat: add panel server start script #1
52
README.md
52
README.md
@ -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
|
||||
```
|
||||
|
||||
|
||||
272
start.sh
Executable file
272
start.sh
Executable file
@ -0,0 +1,272 @@
|
||||
#!/usr/bin/env bash
|
||||
set -Eeuo pipefail
|
||||
|
||||
ROOT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
|
||||
PACK_DIR="${PT_PACK_DIR:-$ROOT_DIR/server-01-random-block}"
|
||||
RUNTIME_DIR="${PT_RUNTIME_DIR:-$ROOT_DIR/.pt-panel-runtime}"
|
||||
MODS_DIR="${PT_MODS_DIR:-$ROOT_DIR/mods}"
|
||||
DOWNLOAD_DIR="$RUNTIME_DIR/downloads"
|
||||
STAMP_FILE="$RUNTIME_DIR/fabric-install.stamp"
|
||||
|
||||
JAVA_BIN="${JAVA_BIN:-java}"
|
||||
JAVA_ARGS="${PT_JAVA_ARGS:--Xms1G -Xmx2G}"
|
||||
SERVER_JAR_OVERRIDE="${PT_SERVER_JAR:-}"
|
||||
FORCE_UPDATE="${PT_FORCE_UPDATE:-0}"
|
||||
DRY_RUN="${PT_DRY_RUN:-0}"
|
||||
SKIP_HASH_CHECK="${PT_SKIP_HASH_CHECK:-0}"
|
||||
AUTO_EULA="${PT_AUTO_EULA:-TRUE}"
|
||||
|
||||
log() {
|
||||
printf '[pt-panel] %s\n' "$*"
|
||||
}
|
||||
|
||||
fail() {
|
||||
printf '[pt-panel] ERROR: %s\n' "$*" >&2
|
||||
exit 1
|
||||
}
|
||||
|
||||
need_cmd() {
|
||||
command -v "$1" >/dev/null 2>&1 || fail "缺少命令: $1"
|
||||
}
|
||||
|
||||
fetch() {
|
||||
local url="$1"
|
||||
local dest="$2"
|
||||
|
||||
if command -v curl >/dev/null 2>&1; then
|
||||
curl -fL --retry 3 --retry-delay 2 -o "$dest" "$url"
|
||||
elif command -v wget >/dev/null 2>&1; then
|
||||
wget -O "$dest" "$url"
|
||||
else
|
||||
fail "缺少 curl 或 wget，无法下载文件"
|
||||
fi
|
||||
}
|
||||
|
||||
fetch_to_stdout() {
|
||||
local url="$1"
|
||||
|
||||
if command -v curl >/dev/null 2>&1; then
|
||||
curl -fL --retry 3 --retry-delay 2 "$url"
|
||||
elif command -v wget >/dev/null 2>&1; then
|
||||
wget -O - "$url"
|
||||
else
|
||||
fail "缺少 curl 或 wget，无法下载文件"
|
||||
fi
|
||||
}
|
||||
|
||||
trim_quotes() {
|
||||
local value="$1"
|
||||
value="${value#\"}"
|
||||
value="${value%\"}"
|
||||
printf '%s' "$value"
|
||||
}
|
||||
|
||||
toml_value() {
|
||||
local key="$1"
|
||||
local file="$2"
|
||||
local line
|
||||
|
||||
line="$(grep -E "^${key}[[:space:]]*=" "$file" | head -n 1 || true)"
|
||||
[ -n "$line" ] || return 1
|
||||
line="${line#*=}"
|
||||
line="${line#${line%%[![:space:]]*}}"
|
||||
trim_quotes "$line"
|
||||
}
|
||||
|
||||
hash_cmd_for() {
|
||||
case "$1" in
|
||||
sha512) echo sha512sum ;;
|
||||
sha256) echo sha256sum ;;
|
||||
sha1) echo sha1sum ;;
|
||||
md5) echo md5sum ;;
|
||||
*) return 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
verify_hash() {
|
||||
local file="$1"
|
||||
local expected="$2"
|
||||
local format="$3"
|
||||
local cmd actual
|
||||
|
||||
[ "$SKIP_HASH_CHECK" = "1" ] && return 0
|
||||
|
||||
cmd="$(hash_cmd_for "$format" || true)"
|
||||
[ -n "$cmd" ] || return 0
|
||||
command -v "$cmd" >/dev/null 2>&1 || return 0
|
||||
|
||||
actual="$($cmd "$file" | awk '{print $1}')"
|
||||
[ "$actual" = "$expected" ]
|
||||
}
|
||||
|
||||
ensure_dirs() {
|
||||
mkdir -p "$RUNTIME_DIR" "$DOWNLOAD_DIR" "$MODS_DIR"
|
||||
}
|
||||
|
||||
load_pack_versions() {
|
||||
[ -f "$PACK_DIR/pack.toml" ] || fail "找不到 $PACK_DIR/pack.toml，请确认已上传服务端 pack 文件"
|
||||
|
||||
MINECRAFT_VERSION="$(toml_value 'minecraft' "$PACK_DIR/pack.toml")"
|
||||
FABRIC_LOADER_VERSION="$(toml_value 'fabric' "$PACK_DIR/pack.toml")"
|
||||
|
||||
[ -n "$MINECRAFT_VERSION" ] || fail "无法从 $PACK_DIR/pack.toml 读取 minecraft 版本"
|
||||
[ -n "$FABRIC_LOADER_VERSION" ] || fail "无法从 $PACK_DIR/pack.toml 读取 fabric 版本"
|
||||
}
|
||||
|
||||
load_latest_fabric_installer_version() {
|
||||
local meta version
|
||||
meta="$(fetch_to_stdout 'https://meta.fabricmc.net/v2/versions/installer')"
|
||||
version="$(printf '%s\n' "$meta" | grep '"version"' | head -n 1 | sed 's/.*"version": *"\([^"]*\)".*/\1/')"
|
||||
[ -n "$version" ] || fail "无法获取最新 Fabric installer 版本"
|
||||
printf '%s' "$version"
|
||||
}
|
||||
|
||||
install_fabric_server() {
|
||||
local installer_version installer_jar wanted_stamp current_stamp
|
||||
|
||||
installer_version="$(load_latest_fabric_installer_version)"
|
||||
installer_jar="$DOWNLOAD_DIR/fabric-installer-${installer_version}.jar"
|
||||
wanted_stamp="mc=$MINECRAFT_VERSION loader=$FABRIC_LOADER_VERSION installer=$installer_version"
|
||||
current_stamp="$(cat "$STAMP_FILE" 2>/dev/null || true)"
|
||||
|
||||
if [ "$FORCE_UPDATE" != "1" ] && [ -f "$ROOT_DIR/fabric-server-launch.jar" ] && [ "$wanted_stamp" = "$current_stamp" ]; then
|
||||
log "Fabric 服务端已就绪，跳过重复安装"
|
||||
return 0
|
||||
fi
|
||||
|
||||
log "准备安装 Fabric 服务端 (Minecraft $MINECRAFT_VERSION / Loader $FABRIC_LOADER_VERSION)"
|
||||
fetch "https://maven.fabricmc.net/net/fabricmc/fabric-installer/${installer_version}/fabric-installer-${installer_version}.jar" "$installer_jar"
|
||||
|
||||
if [ "$DRY_RUN" = "1" ]; then
|
||||
log "DRY RUN: 跳过执行 Fabric installer"
|
||||
return 0
|
||||
fi
|
||||
|
||||
"$JAVA_BIN" -jar "$installer_jar" server -mcversion "$MINECRAFT_VERSION" -loader "$FABRIC_LOADER_VERSION" -downloadMinecraft
|
||||
printf '%s\n' "$wanted_stamp" > "$STAMP_FILE"
|
||||
}
|
||||
|
||||
sync_mods() {
|
||||
local meta file_name url hash_format hash dest tmp
|
||||
|
||||
shopt -s nullglob
|
||||
local files=("$PACK_DIR"/mods/*.pw.toml)
|
||||
shopt -u nullglob
|
||||
|
||||
[ "${#files[@]}" -gt 0 ] || fail "在 $PACK_DIR/mods 下没有找到任何 .pw.toml 模组定义"
|
||||
|
||||
for meta in "${files[@]}"; do
|
||||
file_name="$(toml_value 'filename' "$meta")"
|
||||
url="$(toml_value 'url' "$meta")"
|
||||
hash_format="$(toml_value 'hash-format' "$meta" || true)"
|
||||
hash="$(toml_value 'hash' "$meta" || true)"
|
||||
|
||||
[ -n "$file_name" ] || fail "无法读取 $meta 中的 filename"
|
||||
[ -n "$url" ] || fail "无法读取 $meta 中的 download.url"
|
||||
|
||||
dest="$MODS_DIR/$file_name"
|
||||
|
||||
if [ "$FORCE_UPDATE" != "1" ] && [ -f "$dest" ]; then
|
||||
if [ -n "$hash_format" ] && [ -n "$hash" ]; then
|
||||
if verify_hash "$dest" "$hash" "$hash_format"; then
|
||||
log "模组已存在且校验通过: $file_name"
|
||||
continue
|
||||
fi
|
||||
log "模组校验失败，重新下载: $file_name"
|
||||
else
|
||||
log "模组已存在，跳过下载: $file_name"
|
||||
continue
|
||||
fi
|
||||
else
|
||||
log "下载模组: $file_name"
|
||||
fi
|
||||
|
||||
if [ "$DRY_RUN" = "1" ]; then
|
||||
log "DRY RUN: 跳过下载 $url"
|
||||
continue
|
||||
fi
|
||||
|
||||
tmp="$dest.part"
|
||||
fetch "$url" "$tmp"
|
||||
|
||||
if [ -n "$hash_format" ] && [ -n "$hash" ] && ! verify_hash "$tmp" "$hash" "$hash_format"; then
|
||||
rm -f "$tmp"
|
||||
fail "模组校验失败: $file_name"
|
||||
fi
|
||||
|
||||
mv "$tmp" "$dest"
|
||||
done
|
||||
}
|
||||
|
||||
write_eula() {
|
||||
if [ "$AUTO_EULA" = "TRUE" ] || [ "$AUTO_EULA" = "true" ] || [ "$AUTO_EULA" = "1" ]; then
|
||||
printf 'eula=true\n' > "$ROOT_DIR/eula.txt"
|
||||
log "已写入 eula.txt"
|
||||
else
|
||||
log "已跳过自动写入 EULA（PT_AUTO_EULA=$AUTO_EULA）"
|
||||
fi
|
||||
}
|
||||
|
||||
find_server_jar() {
|
||||
if [ -n "$SERVER_JAR_OVERRIDE" ]; then
|
||||
printf '%s' "$SERVER_JAR_OVERRIDE"
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ -f "$ROOT_DIR/fabric-server-launch.jar" ]; then
|
||||
printf '%s' "$ROOT_DIR/fabric-server-launch.jar"
|
||||
return 0
|
||||
fi
|
||||
|
||||
local candidate
|
||||
candidate="$(find "$ROOT_DIR" -maxdepth 1 -type f \( -name 'fabric-server-launch.jar' -o -name 'fabric-server-*.jar' -o -name 'server.jar' \) | sort | head -n 1 || true)"
|
||||
[ -n "$candidate" ] || return 1
|
||||
printf '%s' "$candidate"
|
||||
}
|
||||
|
||||
start_server() {
|
||||
local server_jar
|
||||
server_jar="$(find_server_jar || true)"
|
||||
|
||||
if [ "$DRY_RUN" = "1" ]; then
|
||||
if [ -n "$server_jar" ]; then
|
||||
log "使用服务端文件: $server_jar"
|
||||
else
|
||||
log "DRY RUN: 当前尚未生成服务端 jar；正式运行时会先执行 Fabric installer"
|
||||
fi
|
||||
log "启动参数: $JAVA_ARGS"
|
||||
log "DRY RUN: 跳过实际启动"
|
||||
return 0
|
||||
fi
|
||||
|
||||
[ -n "$server_jar" ] || fail "找不到可启动的服务端 jar，请检查 Fabric 安装是否成功"
|
||||
|
||||
log "使用服务端文件: $server_jar"
|
||||
log "启动参数: $JAVA_ARGS"
|
||||
|
||||
cd "$ROOT_DIR"
|
||||
exec "$JAVA_BIN" $JAVA_ARGS -jar "$server_jar" nogui
|
||||
}
|
||||
|
||||
main() {
|
||||
need_cmd "$JAVA_BIN"
|
||||
need_cmd grep
|
||||
need_cmd sed
|
||||
need_cmd awk
|
||||
need_cmd find
|
||||
|
||||
ensure_dirs
|
||||
load_pack_versions
|
||||
|
||||
log "根目录: $ROOT_DIR"
|
||||
log "Pack 目录: $PACK_DIR"
|
||||
log "Minecraft 版本: $MINECRAFT_VERSION"
|
||||
log "Fabric Loader 版本: $FABRIC_LOADER_VERSION"
|
||||
|
||||
install_fabric_server
|
||||
sync_mods
|
||||
write_eula
|
||||
start_server
|
||||
}
|
||||
|
||||
main "$@"
|
||||
Reference in New Issue
Block a user