# /etc/ssh/sshd_config

# 禁用 root 登录
PermitRootLogin no

# 禁用密码登录
PasswordAuthentication no

# 仅允许密钥登录
PubkeyAuthentication yes

# 限制登录用户
AllowUsers minecraft

# 修改默认端口
Port 2222

# 设置登录超时
ClientAliveInterval 300
ClientAliveCountMax 2

# 重启 SSH
sudo systemctl restart sshd

# 创建专用用户
sudo useradd -r -m -d /opt/minecraft -s /bin/bash minecraft

# 设置强密码
sudo passwd minecraft

# 限制 sudo 权限
sudo visudo
# minecraft ALL=(ALL) NOPASSWD: /usr/bin/systemctl restart minecraft
# minecraft ALL=(ALL) NOPASSWD: /usr/bin/systemctl stop minecraft

# 设置文件权限
sudo chown -R minecraft:minecraft /opt/minecraft
sudo chmod 750 /opt/minecraft

#!/bin/bash
# security-audit.sh - 安全审计脚本

echo "=== 安全审计报告 ==="
echo "日期: $(date)"
echo ""

# 1. 检查 OP 列表
echo "--- OP 列表 ---"
cat /opt/minecraft/paper/ops.json | python3 -m json.tool

# 2. 检查白名单
echo "--- 白名单 ---"
cat /opt/minecraft/paper/whitelist.json | python3 -m json.tool

# 3. 检查封禁列表
echo "--- 封禁玩家 ---"
cat /opt/minecraft/paper/banned-players.json | python3 -m json.tool

# 4. 检查插件列表
echo "--- 已安装插件 ---"
ls /opt/minecraft/paper/plugins/*.jar | xargs -I{} basename {}

# 5. 检查文件权限
echo "--- 关键文件权限 ---"
ls -la /opt/minecraft/paper/server.properties
ls -la /opt/minecraft/paper/eula.txt

# 6. 检查开放端口
echo "--- 开放端口 ---"
sudo ss -tlnp

# 7. 检查防火墙规则
echo "--- 防火墙规则 ---"
sudo ufw status verbose

#!/bin/bash
# update-paper.sh - PaperMC 自动更新脚本

SERVER_DIR="/opt/minecraft/paper"
BACKUP_DIR="/opt/minecraft/backups/pre-update"
MINECRAFT_VERSION="1.21.4"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

echo "=== PaperMC 自动更新 ==="
echo "目标版本: ${MINECRAFT_VERSION}"

# 1. 获取最新构建号
LATEST_BUILD=$(curl -s "https://api.papermc.io/v2/projects/paper/versions/${MINECRAFT_VERSION}/builds" \
  | python3 -c "import json,sys; print(json.load(sys.stdin)['builds'][-1]['build'])")

# 获取当前版本
CURRENT_BUILD=$(java -jar ${SERVER_DIR}/paper.jar --version 2>/dev/null | grep -oP '\d+$')

echo "当前版本: ${CURRENT_BUILD}"
echo "最新版本: ${LATEST_BUILD}"

if [ "$CURRENT_BUILD" = "$LATEST_BUILD" ]; then
    echo "已是最新版本，无需更新"
    exit 0
fi

# 2. 创建更新前备份
echo "创建更新前备份..."
mkdir -p "$BACKUP_DIR"
cp "${SERVER_DIR}/paper.jar" "${BACKUP_DIR}/paper_${TIMESTAMP}.jar"

# 3. 停止服务器
echo "停止服务器..."
sudo systemctl stop minecraft
sleep 5

# 4. 下载新版本
echo "下载 PaperMC ${MINECRAFT_VERSION} build ${LATEST_BUILD}..."
JAR_NAME="paper-${MINECRAFT_VERSION}-${LATEST_BUILD}.jar"
curl -o "${SERVER_DIR}/paper.jar" \
  "https://api.papermc.io/v2/projects/paper/versions/${MINECRAFT_VERSION}/builds/${LATEST_BUILD}/downloads/${JAR_NAME}"

# 5. 启动服务器
echo "启动服务器..."
sudo systemctl start minecraft

# 6. 检查启动是否成功
sleep 30
if sudo systemctl is-active minecraft; then
    echo "✅ 更新成功！"
    echo "新版本: PaperMC ${MINECRAFT_VERSION} build ${LATEST_BUILD}"
else
    echo "❌ 更新失败，回滚到旧版本..."
    cp "${BACKUP_DIR}/paper_${TIMESTAMP}.jar" "${SERVER_DIR}/paper.jar"
    sudo systemctl start minecraft
    echo "已回滚到版本 ${CURRENT_BUILD}"
fi

#!/bin/bash
# update-plugins.sh - 插件更新检查脚本

PLUGIN_DIR="/opt/minecraft/paper/plugins"
LOG_FILE="/var/log/mc-plugin-update.log"

echo "=== 插件更新检查 ===" | tee -a "$LOG_FILE"

# 检查 SpigotMC 资源更新（需要资源 ID）
check_spigot_update() {
    local resource_id="$1"
    local current_version="$2"

    # 使用 Spiget API 检查更新
    local latest=$(curl -s "https://api.spiget.org/v2/resources/${resource_id}/versions/latest" \
        | python3 -c "import json,sys; print(json.load(sys.stdin).get('name', 'unknown'))" 2>/dev/null)

    if [ "$latest" != "$current_version" ] && [ "$latest" != "unknown" ]; then
        echo "  ⚠️ 发现更新: ${current_version} → ${latest}" | tee -a "$LOG_FILE"
        return 0
    else
        echo "  ✅ 已是最新: ${current_version}" | tee -a "$LOG_FILE"
        return 1
    fi
}

# 遍历插件目录
for jar in ${PLUGIN_DIR}/*.jar; do
    if [ -f "$jar" ]; then
        NAME=$(unzip -p "$jar" plugin.yml 2>/dev/null | grep "^name:" | cut -d: -f2 | tr -d ' ')
        VERSION=$(unzip -p "$jar" plugin.yml 2>/dev/null | grep "^version:" | cut -d: -f2 | tr -d ' ')
        echo "检查: ${NAME} (${VERSION})" | tee -a "$LOG_FILE"
    fi
done

#!/bin/bash
# daily-check.sh - 每日检查脚本

echo "=== 每日服务器检查 ==="
echo "日期: $(date)"

# 1. 服务器状态
echo "--- 服务器状态 ---"
if systemctl is-active minecraft; then
    echo "✅ 服务运行中"
else
    echo "❌ 服务已停止！"
fi

# 2. TPS 和内存
echo "--- 性能指标 ---"
docker exec mc-paper rcon-cli "spark tps" 2>/dev/null || echo "RCON 不可用"

# 3. 磁盘空间
echo "--- 磁盘空间 ---"
df -h /opt/minecraft

# 4. 备份状态
echo "--- 最新备份 ---"
ls -lt /opt/minecraft/backups/*.tar.gz | head -3

# 5. 日志错误
echo "--- 最近错误 ---"
grep -c "ERROR" /opt/minecraft/paper/logs/latest.log

#!/bin/bash
# weekly-check.sh - 每周检查脚本

echo "=== 每周服务器检查 ==="

# 1. 安全审计
/opt/minecraft/scripts/security-audit.sh

# 2. 性能分析
# 启动 Spark Profiler 5 分钟
# /spark profiler --timeout 300

# 3. 备份验证
# 验证最新备份的完整性
LATEST_BACKUP=$(ls -t /opt/minecraft/backups/*.tar.gz | head -1)
/opt/minecraft/scripts/verify-backup.sh "$LATEST_BACKUP"

# 4. 更新检查
/opt/minecraft/scripts/update-paper.sh --check-only

# 5. 清理旧日志
find /opt/minecraft/paper/logs -name "*.log.gz" -mtime +30 -delete
find /opt/minecraft/paper/crash-reports -mtime +30 -delete

## 变更记录

| 日期 | 变更内容 | 操作人 | 影响范围 | 回滚方案 | 状态 |
|------|----------|--------|----------|----------|------|
| 2026-05-10 | 升级 PaperMC 1.21.3→1.21.4 | Admin | 全部 | 使用备份 JAR | ✅ |
| 2026-05-08 | 安装 Vulcan 反作弊 | Admin | 全部 | 删除插件 JAR | ✅ |
| 2026-05-05 | 修改视距 10→8 | Admin | 全部 | 恢复配置 | ✅ |

## 故障处理记录

- **故障时间**：2026-05-10 14:30 - 15:00
- **严重级别**：P1
- **影响范围**：所有玩家
- **故障现象**：TPS 降至 8，玩家普遍反映卡顿
- **根本原因**：生存服大量僵尸堆积（~3000 只）
- **处理过程**：
  1. 14:35 收到玩家反馈
  2. 14:38 Spark Profiler 启动分析
  3. 14:42 定位到实体问题
  4. 14:45 执行 `/kill @e[type=zombie,distance=100..]`
  5. 14:47 TPS 恢复正常
- **预防措施**：
  - 调整 spigot.yml 中 `spawn-limits.monsters` 从 70 降至 50
  - 配置 ClearLagg 定时清理实体
- **后续跟进**：持续监控一周

## 灾难恢复清单

### 1. 服务器崩溃/硬件故障
- [ ] 确认备份位置和最新时间
- [ ] 准备替代服务器（云/本地）
- [ ] 恢复备份到新服务器
- [ ] 验证数据完整性
- [ ] 更新 DNS/端口转发
- [ ] 通知玩家新连接信息

### 2. 数据损坏
- [ ] 停止服务器防止进一步损坏
- [ ] 评估损坏范围
- [ ] 从备份恢复
- [ ] 使用 CoreProtect 回滚部分操作
- [ ] 验证恢复结果

### 3. 安全事件
- [ ] 隔离受影响的服务器
- [ ] 封禁攻击者
- [ ] 审计损失
- [ ] 从备份恢复
- [ ] 加固安全配置

### 4. 勒索软件攻击
- [ ] 断开网络连接
- [ ] 不支付赎金
- [ ] 从离线备份恢复
- [ ] 清除感染
- [ ] 加固安全配置

# 服务器规则

## 基本规则
1. 尊重其他玩家
2. 禁止作弊/利用漏洞
3. 禁止恶意破坏
4. 禁止不当言论
5. 遵循管理员指示

## 处罚流程
1. 第一次违规：警告
2. 第二次违规：禁言 1 小时
3. 第三次违规：封禁 1 天
4. 第四次违规：永久封禁
5. 严重违规：直接永久封禁

## 申诉渠道
- QQ 群：123456
- 邮箱：admin@example.com