综合实战 · Minecraft Bedrock Server 官方安装指南

难度:⭐⭐⭐⭐⭐(最高) 等价 KET 部分:Full English Reading(全英文) 前置条件:必须先完成 Tier 1-3 的所有节点


阅读目标

读完这篇之后,Aaron 能够:

  1. 读懂 BDS(Bedrock Dedicated Server)的官方安装说明
  2. 理解每一条命令的英文解释
  3. 独立完成 Minecraft 服务器搭建(不需要爸爸一步步带)

原文一 · 官方 README(真实文档节选)

来自 BDS Linux 版 README.txt,下载服务器压缩包后可以找到。


原文

SETTING UP A SERVER

1. Download the server to a location where you want the server to be.
2. Extract the package to an appropriate location.
3. Configure your server with server.properties.
4. Start the server with ./bedrock_server.
5. If you want server to listen on a port below 1024, you need to give 
   the server additional privileges using setcap:
   sudo setcap 'cap_net_bind_service=+ep' bedrock_server

Notes:
- The server currently only runs on Ubuntu 18.04 or higher.
- The server needs port 19132/udp and 19133/udp to be open.
- If you're running a firewall (UFW), run:
  sudo ufw allow 19132/udp
  sudo ufw allow 19133/udp
📖 逐句精讲(点击展开)

Download the server to a location where you want the server to be

  • to a location where = 到你想放服务器的那个位置
  • 意思:下载到你打算运行服务器的文件夹
  • 你应该下载到:~/mc-server/(或者直接在那里解压)

Extract the package to an appropriate location

  • extract = 解压(这就是 unziptar 的操作)
  • appropriate location = 合适的位置
  • 解压命令:unzip bedrock-server-xxx.zip -d ~/mc-server/

Configure your server with server.properties

  • configure = 配置
  • server.properties = 服务器配置文件
  • 用什么改?用 nanonano ~/mc-server/server.properties

Start the server with ./bedrock_server

  • ./ = 在当前目录(不要省略这个点)
  • bedrock_server = 服务器主程序(没有 .exe,Linux 可执行文件无后缀)
  • 先要 chmod +x bedrock_server 加执行权限

port below 1024

  • Linux 系统的 0-1023 号端口是”特权端口”,普通用户不能用
  • Minecraft 默认用 19132,比 1024 大,所以通常不需要这一步
  • 如果你改成 80 或 443 那就需要 setcap

port 19132/udp and 19133/udp

  • udp = UDP 协议(Minecraft 用 UDP 而不是 TCP,响应更快)
  • 19132 = IPv4 端口(Xbox/iPad 连接用这个)
  • 19133 = IPv6 端口(某些网络配置需要)

UFW = Uncomplicated FireWall(Ubuntu 的防火墙工具)

  • sudo ufw allow 19132/udp = 允许 UDP 19132 端口通过防火墙
  • 如果不开这个,局域网内的其他设备连不进来

原文二 · server.properties 配置文件(真实内容节选)

# These are the settings for the Minecraft Bedrock Edition dedicated server.
# Server name shows up in the server list
server-name=Dedicated Server
 
# The world will be saved to this directory
level-name=Bedrock level
 
# The maximum number of players that can play on the server at the same time.
max-players=10
 
# The UDP port the server will listen on.
server-port=19132
 
# Enables/Disables cheats (gamemode switching, etc)
allow-cheats=false
 
# Sets the game mode for new players
gamemode=survival
 
# Sets the difficulty of the world
difficulty=easy
📖 逐项精讲(点击展开)

server-name=Dedicated Server

  • 改成你想要的名字,这个名字会显示在局域网服务器列表里
  • 建议改成:server-name=Aaron的世界

level-name=Bedrock level

  • level = 关卡/世界
  • 服务器会在 worlds/Bedrock level/ 目录里存游戏存档
  • 可以改名,但改了之后要去 worlds/ 目录里对应重命名

max-players=10

  • 局域网里只有几个人玩,改成 4 就够了
  • 改太大也没意义,服务器内存是有限的

server-port=19132

  • 不要乱改这个!改了之后设备连接时也要改端口号
  • 保持默认 19132 最简单

allow-cheats=false

  • cheats = 作弊(切换游戏模式、创造模式物品等)
  • false = 关闭,正常生存游戏
  • 如果想开创造模式:改成 true,但这样生存意义就少了

gamemode=survival

  • survival = 生存模式(正常玩法)
  • creative = 创造模式(无限资源)
  • adventure = 冒险模式(不能破坏方块)

difficulty=easy

  • peaceful = 和平(没有怪物)
  • easy = 简单
  • normal = 普通
  • hard = 困难

实战任务 · 完整搭建 Minecraft Bedrock Server

按照下面的步骤,完全自己动手完成服务器搭建。 每完成一步,在旁边打勾。真实的工程项目就是这样——一步一步来,出错就查,查好再走。

步骤清单

# ─── 步骤 1:准备目录 ───────────────────────────
mkdir -p ~/mc-server
cd ~/mc-server
 
 
# ─── 步骤 2:下载服务器(二选一方案)─────────────
# 微软现在对 wget 直连有 User-Agent 过滤,所以有两种办法:
 
# 方案 A:wget + User-Agent(推荐,单机一步到位)
#   去 https://www.minecraft.net/en-us/download/server/bedrock
#   复制 Ubuntu Linux 版本的下载链接
wget -U "Mozilla/5.0" -O bedrock-server.zip "你复制的链接"
 
# 方案 B:浏览器下载 + scp 传输(备用,Mac 下载后传到笔记本)
#   1. 在 Mac 上用 Safari/Chrome 下载 zip 到桌面
#   2. 用 scp 传到笔记本:
#      scp ~/Desktop/bedrock-server-*.zip aaron-xiaomi:~/mc-server/bedrock-server.zip
 
 
# ─── 步骤 3:确认下载成功 ────────────────────────
ls -lh bedrock-server.zip
# 应该是 100-150MB 左右;如果只有几 KB,那是下载了一个错误页面,重来
 
 
# ─── 步骤 4:安装解压工具和运行库 ─────────────────
# bedrock_server 依赖系统的 libssl 库,Ubuntu 24.04 可能缺某些版本
sudo apt update
sudo apt install unzip libssl-dev -y
 
 
# ─── 步骤 5:解压 ───────────────────────────────
unzip bedrock-server.zip
# 不加 -d,因为我们已经在 mc-server 目录里了
# 解压后应该看到:bedrock_server(主程序)、server.properties、worlds/、各种 .so 文件
 
 
# ─── 步骤 6:给主程序加执行权限 ───────────────────
chmod +x bedrock_server
ls -la bedrock_server
# 应该看到 -rwxr-xr-x,有 x 说明能执行
 
 
# ─── 步骤 7:配置服务器 ──────────────────────────
nano server.properties
# 修改这几项:
#   server-name=Aaron的世界
#   difficulty=easy
#   max-players=4
# 保存:Ctrl+O → Enter → Ctrl+X
 
 
# ─── 步骤 8:开防火墙(顺序很重要!)──────────────
# 先确保 SSH 端口开着,否则 enable 之后爸爸远程连不进来了
sudo ufw allow 22/tcp           # SSH 端口,保命
sudo ufw allow 19132/udp        # Minecraft IPv4
sudo ufw allow 19133/udp        # Minecraft IPv6
 
# 现在才能启用防火墙
sudo ufw enable                 # 会警告 "may disrupt existing ssh connections"
                                # 因为已经 allow 22 了,放心按 y
 
sudo ufw status                 # 确认 3 条规则都是 ALLOW
 
 
# ─── 步骤 9:查自己笔记本的 IP(告诉朋友用的)─────
hostname -I
# 192.168.3.43   ← 这就是小伙伴的 iPad/Xbox 要填的地址
# 如果输出多个 IP,取 192.168 或 10. 开头的那个(局域网地址)
# ⚠ 家里 WiFi 重启后 IP 可能变,连不上时先重新 hostname -I
 
 
# ─── 步骤 10:启动服务器!────────────────────────
# 关键:必须加 LD_LIBRARY_PATH=. 告诉系统去当前目录找 .so 库
LD_LIBRARY_PATH=. ./bedrock_server
 
# 如果直接 ./bedrock_server 会报错:
#   error while loading shared libraries: libCrypto.so.3:
#   cannot open shared object file: No such file or directory
# 这不是你错了,是 Linux 默认不去程序当前目录找库文件

验证步骤

服务器启动成功的标志(终端输出):
  NO LOG FILE! - [INFO] Starting Server
  NO LOG FILE! - [INFO] Version: 1.21.x.x
  NO LOG FILE! - [INFO] Level Name: Aaron的世界
  NO LOG FILE! - [INFO] Game mode: 0 Survival
  NO LOG FILE! - [INFO] Difficulty: 1 EASY
  Server started.

看到 Server started. ——就成功了!启动后终端会停在一个输入提示符上,这就是 Minecraft 服务器的控制台,可以直接打游戏命令:

> list                    # 查看在线玩家
> op Aaron                # 给 Aaron 管理员权限
> time set day            # 设为白天
> stop                    # 停止服务器(优雅关闭,存档自动保存)

连接测试

  1. 确保 iPad/Xbox 和 Aaron 的笔记本在同一个 WiFi
  2. 打开 Minecraft(Bedrock 版)
  3. 进入”游玩” → “服务器” → “添加服务器”
  4. 输入 Aaron 笔记本的 IP:步骤 9 查到的 hostname -I 结果
  5. 端口:19132
  6. 连接,进入世界!

第一次成功连上后:建议 Aaron 自己截图保存,作为「我搭建了一个真正的服务器」的纪念。

停止服务器

# 在服务器终端里,输入:
stop
# 这是最推荐的方式——服务器会把存档保存好再退出
 
# 紧急情况才用:
# Ctrl + C(强制中断,有存档丢失风险)

❗ 故障排查手册

真实的服务器搭建不会一次成功。下面是最常见的几个坑,看到报错不用慌,90% 都在下面

🔴 报错 1:error while loading shared libraries

./bedrock_server: error while loading shared libraries:
libCrypto.so.3: cannot open shared object file: No such file or directory

原因:Linux 默认不去程序所在目录找 .so 库文件。 解决:启动时加前缀

LD_LIBRARY_PATH=. ./bedrock_server

🔴 报错 2:Permission denied

bash: ./bedrock_server: Permission denied

原因:文件没有执行权限。 解决

chmod +x bedrock_server
ls -la bedrock_server         # 检查应该有 -rwxr-xr-x

🔴 报错 3:Address already in use

[ERROR] Failed to bind to port 19132: Address already in use

原因:上一次服务器没关干净,端口还被占用。 解决

sudo ss -ulnp | grep 19132    # 看谁在用这个端口
# 找到 pid=XXXX 后
kill XXXX                     # 温柔结束
# 如果不行
kill -9 XXXX                  # 强制结束

🔴 报错 4:小伙伴连不上(但服务器日志说 Server started)

检查清单

  1. hostname -I 查到的 IP 给对了吗?(不是 127.0.0.1)
  2. 是否在同一个 WiFi?(邻居楼的 WiFi 不算)
  3. sudo ufw status 看 19132/udp 有没有 ALLOW?
  4. iPad 端是否填对了端口 19132?

🔴 报错 5:下载的 zip 只有几 KB

原因:微软对不带 User-Agent 的 wget 返回的是 403 错误页面。 解决:参考步骤 2 的方案 A 或 B。

🔴 报错 6:systemctl 启动后服务立刻退出

$ sudo systemctl status mc-server
... Active: failed (Result: exit-code)

排查:查日志

sudo journalctl -u mc-server -n 50

最常见的原因:

  • .service 文件里忘了加 Environment="LD_LIBRARY_PATH=/home/aaron/mc-server"
  • WorkingDirectory= 路径写错
  • User=aaron 的 aaron 拼错(用 whoami 确认)

英文词汇总结

词汇含义出现在哪里
dedicated server专用服务器BDS 全称 Bedrock Dedicated Server
extract解压unzip/tar 的英文说法
configure配置编辑 server.properties
privileges权限需要管理员权限
firewall防火墙UFW = Uncomplicated Firewall
allow允许ufw allow 开放端口
listen监听服务器在某个端口”等待”连接

节点链接

用到了这些节点(本篇是终点)
  [[sudo]]   ← sudo ufw allow
  [[apt]]    ← sudo apt install unzip
  [[wget]]   ← 下载服务器压缩包
  [[unzip]]  ← 解压 .zip
  [[chmod]]  ← chmod +x bedrock_server
  [[nano]]   ← 编辑 server.properties
  [[ps]]     ← 检查服务器进程是否在运行
  [[find]]   ← 找到存档目录
  [[grep]]   ← 在日志里找错误

前置确认清单
  Tier 1 ← 基础文件操作(ls, cd, mkdir, cp, mv)
  Tier 2 ← 侦探工具(find, grep, 管道, tail)
  Tier 3 ← 软件与权限 + 编辑器(sudo, apt, unzip, chmod, nano)
  Tier 4 ← 自动化 + 防火墙(ps, kill, ufw, shell-script, cron, systemctl)

文档版本:v1.0 · 2026-04-20 这是整个课程的终点,也是新旅程的起点 🎮