1. 项目概述为什么选择rAthena如果你对搭建一个属于自己的、可高度自定义的在线游戏世界感兴趣那么rAthena这个名字你一定不陌生。它是一款基于C语言开发的开源Ragnarok OnlineRO模拟器是目前社区最活跃、功能最完善的RO服务器端解决方案之一。简单来说它让你可以在一台普通的电脑上复刻甚至超越当年官方服务器的游戏体验从职业平衡、技能效果、怪物AI到经济系统几乎所有规则都由你说了算。无论是想重温经典还是想创造一个独一无二的私服与朋友联机rAthena都是最核心的基石。我接触rAthena有年头了从早期版本一路跟过来见证了它从功能简陋到如今生态繁荣。很多新手在第一步“安装”上就卡住了网上教程要么年代久远要么语焉不详尤其是在Windows和Linux这两个主流平台上的差异常常让人一头雾水。今天这篇内容就是把我这些年反复安装、配置、踩坑的经验整理成一份超详细的“保姆级”教程。我的目标很明确让你无论用Windows还是Linux都能在半小时内从零开始成功跑起一个干净、可用的rAthena服务器并且理解每一步操作背后的逻辑而不是机械地复制命令。2. 安装前的核心准备环境与工具选型在动手下载任何文件之前充分的准备工作能避免你后续90%的莫名错误。这一步的核心是搭建一个正确的编译和运行环境。2.1 理解rAthena的运行依赖rAthena本质上是一个C语言编写的服务端程序它需要被编译成可执行文件才能运行。因此它的核心依赖是C/C编译器和相关的开发库。除此之外它还需要一个数据库来存储所有游戏数据如角色信息、物品、NPC脚本等最常用的是MariaDBMySQL的一个分支完全兼容且性能更优。所以我们的准备工作就围绕这两大块展开。为什么是MariaDB而不是其他数据库历史原因和社区生态决定了rAthena与MySQL/MariaDB的深度绑定。其数据库结构SQL文件、查询语句都是为MySQL语法优化的。虽然理论上可以通过修改源码适配其他数据库但这会引入巨大的复杂性和不稳定性对于新手和绝大多数应用场景而言直接使用MariaDB是最稳妥、最省事的选择。2.2 Windows平台环境准备在Windows上我们主要解决两个问题编译环境和数据库。1. 编译环境MSYS2 MinGW-w64早期教程可能让你装臃肿的Visual Studio或者老旧的Dev-C。现在最推荐的是MSYS2。它是一个在Windows上提供完整GNU工具链包括GCC编译器、Make、Git等的环境轻量且高效。通过它安装的MinGW-w64编译器能完美编译出原生Windows可执行文件.exe。安装步骤与要点访问MSYS2官网下载安装程序。安装路径强烈建议使用纯英文、无空格的短路径例如C:\msys64。这是为了避免后续编译时可能出现的各种路径解析错误。安装完成后从开始菜单打开MSYS2 UCRT64这个终端。注意MSYS2有多个终端MSYS, MINGW32, MINGW64, UCRT64我们选择UCRT64是因为它使用更新的运行时库兼容性更好。在终端中首先更新软件包数据库pacman -Syu。如果提示关闭终端就照做重新打开后再执行一次pacman -Su确保完全更新。安装编译rAthena所需的工具链pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain git。这个命令会安装GCC、G、Make、Git等一系列必备工具。2. 数据库环境MariaDB去MariaDB官网下载Windows安装程序.msi。安装过程中有几个关键点设置root密码务必设置一个强密码并牢记。不要留空。选择编码在字符集Character Set设置页面务必选择“utf8mb4”。这是为了完美支持所有语言字符包括emoji避免游戏内出现乱码。记住端口号默认是3306如果没被占用保持默认即可。安装完成后建议将MariaDB的bin目录如C:\Program Files\MariaDB 11.3\bin添加到系统的PATH环境变量中这样以后在任意命令行都可以使用mysql命令。注意有些一键安装包会捆绑HeidiSQL或phpMyAdmin这类数据库图形化管理工具。对于新手我强烈建议额外安装一个HeidiSQL。它比命令行直观太多用于创建数据库、导入SQL文件、执行查询等操作非常方便。2.3 Linux平台环境准备Linux下的准备相对统一主要通过包管理器完成。这里以最流行的Ubuntu 22.04 LTS及其衍生版如Debian为例。如果你用CentOS/RHEL系列命令会从apt换成yum或dnf但包名基本类似。打开你的终端依次执行以下命令# 1. 更新软件包列表 sudo apt update # 2. 安装编译工具和依赖库 sudo apt install -y build-essential cmake git libmariadb-dev-compat libmariadb-dev pkg-config zlib1g-dev # 3. 安装MariaDB服务器和客户端 sudo apt install -y mariadb-server mariadb-client # 4. 安全初始化MariaDB非常重要 sudo mysql_secure_installation执行mysql_secure_installation时它会引导你进行一系列安全设置设置root密码和Windows一样设一个强密码。移除匿名用户。禁止root远程登录通常选Y提高安全性。移除测试数据库。立即重载权限表。这些步骤能确保你的数据库基础环境是安全的。关于Linux发行版的选择对于生产环境稳定压倒一切因此推荐Ubuntu LTS或Debian Stable。对于只是想学习测试任何你熟悉的发行版都可以只需根据其包管理器安装上述对应软件包即可。不推荐使用过于前沿的滚动发行版可能会遇到依赖库版本不兼容的问题。3. 获取与编译rAthena源代码环境准备好后我们就可以获取最新的rAthena代码并把它变成可以运行的程序了。这一步两个平台的核心逻辑一致但操作细节不同。3.1 使用Git克隆源代码无论Windows在MSYS2 UCRT64终端里还是Linux我们都使用Git来获取代码。这是最佳实践便于后续更新。# 切换到你打算存放项目的目录例如家目录下的projects文件夹 cd ~ mkdir -p projects cd projects # 克隆rAthena的主仓库 git clone https://github.com/rathena/rathena.git cd rathena这个rathena文件夹就是我们的工作根目录里面包含了所有服务端源代码、配置文件、数据库脚本等。3.2 Windows平台编译详解在MSYS2 UCRT64终端中确保当前目录是rathena。配置编译选项 首先我们需要运行configure脚本。它会检测你的环境并生成对应的编译配置Makefile。./configure这个脚本会询问你一些问题大部分直接按回车选择默认值即可。但有几个关键点Enable 64-bit support?如果你的系统是64位的现在基本都是选yes。这能提高性能并允许服务器使用更多内存。Use PCRE2?这是正则表达式库用于脚本解析。选yes功能更强大。其他关于数据库、加密等的选项通常保持默认启用就好。执行编译 配置完成后直接输入make命令开始编译。make server这个make server命令会编译三个核心服务程序login-server登录服务器、char-server角色服务器、map-server地图服务器。这是标准的三服结构。 编译过程会持续几分钟你会看到大量滚动的输出信息。只要最后没有出现error: ...之类的致命错误并以类似[100%] Built target map-server的提示结束就说明编译成功了。编译结果位置 编译生成的可执行文件.exe位于rathena/目录下。你会看到login-server.exe,char-server.exe,map-server.exe以及一个重要的工具mapcache.exe。实操心得第一次编译时可能会因为网络问题导致某些依赖下载失败如PCRE2。如果./configure失败仔细看错误信息通常它会提示你缺少哪个包。回到MSYS2终端用pacman -Ss 包名搜索然后用pacman -S安装对应的mingw-w64-ucrt-x86_64-开头的开发包即可。3.3 Linux平台编译详解在Linux终端中步骤与Windows高度相似但更简洁。配置与编译cd ~/projects/rathena ./configure make server同样在./configure时根据提示选择64位支持和PCRE2。make server的过程和Windows一样。关键差异与注意事项权限问题编译生成的可执行文件在Linux下可能没有执行权限。编译完成后可以运行chmod x login-server char-server map-server来添加。依赖完整性如果编译报错提示找不到mysql.h或某个库通常是因为前面“环境准备”环节的依赖没装全。回顾3.3节确保libmariadb-dev-compat和libmariadb-dev这两个包已安装。系统服务对于生产环境你可能会希望服务器在系统启动时自动运行。这需要编写systemd服务单元文件但这属于进阶部署范畴本篇先确保能手动运行成功。4. 数据库的初始化与配置服务器程序编译好了但还没有“数据”。我们需要创建一个空的数据库并把rAthena所需的初始数据表结构、基础物品、怪物、技能信息等导入进去。4.1 创建数据库与用户首先登录到MariaDB。在Windows上你可以用HeidiSQL图形化操作或者用命令行。在Linux上我们主要用命令行演示因为这是通用技能。# 使用root用户登录MariaDB控制台 # Linux下可能需要sudo或者直接用系统root权限 sudo mysql -u root -p # 然后输入你之前设置的root密码 # 进入MySQL命令行后执行以下SQL语句-- 1. 创建一个专门用于rAthena的数据库名字通常叫ragnarok CREATE DATABASE ragnarok CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 2. 创建一个专门管理这个数据库的用户比直接使用root更安全 -- rathena_user是用户名your_strong_password_here请替换成你自己的密码 CREATE USER rathena_userlocalhost IDENTIFIED BY your_strong_password_here; -- 3. 授予这个用户对ragnarok数据库的全部权限 GRANT ALL PRIVILEGES ON ragnarok.* TO rathena_userlocalhost; -- 4. 让权限生效 FLUSH PRIVILEGES; -- 5. 退出MySQL控制台 EXIT;安全提醒务必把your_strong_password_here换成高强度密码并且记录下来。后面配置服务器时会用到。4.2 导入初始数据rAthena的sql-files目录里准备了丰富的SQL脚本。我们需要按顺序导入它们。回到终端或HeidiSQL的查询窗口确保当前目录在rathena下然后使用刚创建的用户导入数据# Linux/Windows(MSYS2)命令行方式 # 先切换到sql-files目录下的正确位置 cd sql-files # 主数据库结构。注意这里用的是main.sql不是logs.sql或item_db.sql等。 mysql -u rathena_user -p ragnarok main.sql # 会提示输入 rathena_user 的密码 # 导入基础物品数据库。rAthena提供了多种选择这里用最通用的“re”版。 mysql -u rathena_user -p ragnarok item_db/item_db_re.sql # 导入怪物数据库 mysql -u rathena_user -p ragnarok mob_db/mob_db_re.sql # 导入技能数据库 mysql -u rathena_user -p ragnarok skill_db/skill_db.sql # 根据需要导入其他数据如卡片、宠物等但以上四个是启动服务器的最低要求。导入顺序很重要必须先main.sql创建表结构再导入具体数据。item_db_re.sql和mob_db_re.sql中的“re”代表“Renewal”是RO后续更新的版本体系包含了更多新物品和怪物建议使用。常见问题如果导入时出现大量错误比如“Table already exists”可能是因为你重复执行了导入。在首次搭建时确保数据库ragnarok是空的。如果搞乱了最简单的方法是DROP DATABASE ragnarok;然后从头再来一遍创建和导入。5. 服务器核心配置文件详解数据库有了程序也有了现在需要让它们俩认识一下。这就是配置文件的作用。rAthena的配置文件都在rathena/conf/目录下我们需要修改其中几个关键文件。重要原则修改任何配置文件前先备份原文件例如把inter_athena.conf复制一份为inter_athena.conf.backup。5.1 数据库连接配置inter_athena.conf这个文件负责告诉char-server和map-server如何连接数据库。用文本编辑器如VS Code、Notepad不要用Windows自带的记事本可能编码有问题打开conf/inter_athena.conf。找到如下段落并进行修改// MySQL Login server login_server_ip: 127.0.0.1 login_server_port: 3306 login_server_id: rathena_user // 改为你创建的用户名 login_server_pw: your_strong_password_here // 改为该用户的密码 login_server_db: ragnarok // 数据库名 login_codepage:// MySQL Character server char_server_ip: 127.0.0.1 char_server_port: 3306 char_server_id: rathena_user // 同上 char_server_pw: your_strong_password_here // 同上 char_server_db: ragnarok // 同上// MySQL Map server map_server_ip: 127.0.0.1 map_server_port: 3306 map_server_id: rathena_user // 同上 map_server_pw: your_strong_password_here // 同上 map_server_db: ragnarok // 同上关键点ip地址保持127.0.0.1表示服务器和数据库在同一台机器。port保持3306除非你安装MariaDB时改了端口。id,pw,db这三项必须与你创建数据库和用户时设置的一致。5.2 服务器网络配置char_athena.conf与map_athena.conf这两个文件分别配置角色服务器和地图服务器的网络监听端口。conf/char_athena.conf:char_server_port: 6121这是角色服务器端口客户端会连接这个端口来读取角色列表、创建角色等。通常保持默认6121即可除非端口冲突。conf/map_athena.conf:map_server_port: 5121这是地图服务器端口游戏内所有实时交互移动、战斗、聊天都通过这个端口。通常保持默认5121。关于bind_ip配置文件中可能有bind_ip选项默认是0.0.0.0表示监听所有网络接口。如果你只想让服务器在本地运行仅供本机客户端连接可以改为127.0.0.1。如果希望局域网内其他电脑也能连接则需要保持0.0.0.0并确保防火墙放行了对应端口6121, 5121, 6900。5.3 客户端连接配置clientinfo.xml或packet_db这是最容易出错的一步。服务器需要知道客户端版本以便使用正确的通信协议封包版本。如果这里配置错误客户端将无法连接提示“服务器拒绝连接”或版本不符。对于较新版本的rAthena主要配置在db/packet_db.yml或db/packet_db.txt。你需要根据你使用的客户端如2022年、2023年客户端来设置正确的packet_ver值。更传统和直接的方法是修改clientinfo.xml但这种方式在现代客户端中可能被替代。我们以配置packet_db为例打开db/packet_db.yml。找到开头的ClientPacketsVersion:部分。你会看到很多以日期命名的条目如2022-09-07a、2023-03-15等。你需要知道你客户端对应的封包日期。一个常见的测试方法是先使用一个已知较旧的日期如2022-09-07a。在client: {}部分设置packet_ver: 2022-09-07a。如果不知道客户端日期可以去rAthena的Wiki或相关社区查找常见客户端的封包版本对应表。这是连接成功的关键。6. 启动服务器与首次运行测试激动人心的时刻到了我们将按顺序启动三个服务器程序。6.1 启动顺序与观察日志三个服务器必须按登录服务器 - 角色服务器 - 地图服务器的顺序启动因为它们之间有依赖关系。启动登录服务器 (login-server)Windows: 在文件管理器双击login-server.exe或MSYS2终端运行./login-server。Linux: 在终端运行./login-server。 你会看到一个命令行窗口弹出显示大量初始化信息最后停留在类似[信息]: 服务器正在监听端口 6900 ...的提示上。6900是登录服务器的默认端口。如果看到“监听”成功的消息且没有红色错误说明第一步成功。启动角色服务器 (char-server)打开一个新的终端或命令行窗口不要关闭login-server。Windows: 双击char-server.exe或在新的MSYS2终端运行./char-server。Linux: 新终端cd到rathena目录运行./char-server。 同样观察输出。它会连接数据库加载角色数据最后显示监听端口6121。注意看有没有数据库连接成功的提示。启动地图服务器 (map-server)再打开第三个终端或命令行窗口。Windows: 双击map-server.exe或运行./map-server。Linux: 运行./map-server。 这是最“热闹”的一个窗口。它会加载所有地图、NPC、怪物脚本信息滚动最快。最终会显示监听端口5121并提示所有地图服务器已就绪。如何判断启动成功三个窗口都没有崩溃退出并且分别显示login-server:Listening on port 6900 (IPv4)...char-server:Listening on port 6121 (IPv4)...map-server: 最后一行是[状态]: 服务器 主要 已就绪 (服务器 0 已启动)或类似信息。6.2 使用客户端进行连接测试你需要一个RO客户端通常是一个完整的游戏文件夹。将服务器提供的clientinfo.xml或sclientinfo.xml文件需要根据你的服务器配置生成或修改放入客户端的根目录覆盖原有文件。这个文件里包含了服务器的IP地址127.0.0.1和端口6900。然后运行客户端的登录器通常是ragexe.exe或一个定制的登录器。在登录界面输入账号密码首次登录时账号密码任意输入服务器会自动创建新账号。如果一切配置正确你应该能看到服务器列表选择后进入角色创建或游戏画面。踩坑实录第一次连接失败十有八九是packet_ver不对。如果连接时立刻断开或提示版本错误请回到第5.3节尝试更换packet_db.yml中的版本号。另一个常见原因是防火墙或杀毒软件阻止了程序联网请确保在防火墙中允许这三个.exeWindows或端口Linux通信。7. 常见问题排查与进阶技巧即使按照教程一步步来也可能会遇到问题。这里汇总一些经典故障和解决方法。7.1 启动时报错排查表错误现象可能原因解决方案make编译失败提示fatal error: xxx.h: No such file or directory缺少开发依赖库。Windows在MSYS2中用pacman -S安装对应的mingw-w64-ucrt-x86_64-xxx包。Linux用apt install安装对应的libxxx-dev包。服务器启动时崩溃提示Failed to connect to database数据库连接信息配置错误。1. 检查inter_athena.conf中的用户名、密码、数据库名。2. 确认MariaDB服务已启动Windows服务管理器Linuxsudo systemctl status mariadb。3. 确认用户有远程登录权限如果是非localhost连接。map-server启动时卡在loading NPC...或大量脚本错误NPC脚本语法错误或依赖的脚本文件缺失。1. 检查npc/目录下的脚本文件。2. 可能是自定义脚本问题暂时将npc/scripts_custom.conf中出错的脚本行注释掉行首加//。客户端能登录但看不到服务器列表login-server的clientinfo或封包版本与客户端不匹配。1. 确认客户端使用的clientinfo.xml内容正确IP和端口是127.0.0.1:6900。2. 确认packet_db.yml中的packet_ver与客户端匹配。客户端连接服务器后瞬间断开防火墙阻止了端口通信或者char/map-server的IP绑定设置错误。1. 检查防火墙设置放行6900, 6121, 5121端口。2. 检查char_athena.conf和map_athena.conf中的bind_ip如果是局域网连接应为0.0.0.0。游戏内显示乱码数据库字符集不是utf8mb4。重新创建数据库确保执行CREATE DATABASE ... CHARACTER SET utf8mb4 ...。重新导入SQL文件。7.2 性能优化与安全基础服务器跑起来后你可能会考虑让它更稳定、更安全。基础优化调整地图服务器进程数在map_athena.conf中可以设置map_server_count。如果你的机器是多核CPU可以将其设置为与物理核心数相同或稍少以充分利用多核性能。每个地图服务器进程会分担一部分地图的负载。调整怪物AI频率battle_athena.conf中的monster_active_time和player_active_time可以调整AI计算频率降低CPU占用但会影响游戏响应速度需要根据在线人数权衡。安全须知非常重要修改默认账号密码rAthena的SQL文件中可能包含默认的GM账号如admin。务必在数据库的login表里修改这些账号的密码使用SHA1哈希。限制数据库用户权限我们之前创建的rathena_user只对ragnarok数据库有权限且只能从localhost连接这已经是一个好习惯。绝对不要用root用户来运行游戏服务器。防火墙配置生产服务器必须配置防火墙只开放必要的端口6900, 6121, 5121给客户端22/3389给管理3306通常不对外开放。定期备份定期备份你的ragnarok数据库和rathena/conf、rathena/npc等自定义过的目录。数据库备份可以用mysqldump命令。7.3 后续维护与更新rAthena是一个活跃的开源项目定期会有bug修复和新功能加入。更新源代码cd ~/projects/rathena git pull origin master执行git pull会拉取最新的代码。注意更新后通常需要重新编译./configure make clean # 清理旧的编译文件 make server更新数据库 更新代码后务必检查sql-files目录下是否有新的升级脚本如upgrade_xxxx.sql。如果有需要按顺序执行它们来更新数据库结构mysql -u rathena_user -p ragnarok sql-files/upgrade_xxxx.sql警告在执行任何升级脚本前一定要先备份整个数据库。我个人在维护多个测试服时养成了一个习惯任何配置修改或版本更新前先为整个rathena目录和数据库创建一个带时间戳的备份。这个习惯让我在多次实验失败后能快速回滚节省了大量重装时间。对于刚上手的你我建议先在本地虚拟机或闲置电脑上反复练习整个安装和配置流程直到完全熟悉每一步的含义和可能出现的问题然后再部署到真正的服务器上。
1. 项目概述为什么选择rAthena如果你对搭建一个属于自己的、可高度自定义的在线游戏世界感兴趣那么rAthena这个名字你一定不陌生。它是一款基于C语言开发的开源Ragnarok OnlineRO模拟器是目前社区最活跃、功能最完善的RO服务器端解决方案之一。简单来说它让你可以在一台普通的电脑上复刻甚至超越当年官方服务器的游戏体验从职业平衡、技能效果、怪物AI到经济系统几乎所有规则都由你说了算。无论是想重温经典还是想创造一个独一无二的私服与朋友联机rAthena都是最核心的基石。我接触rAthena有年头了从早期版本一路跟过来见证了它从功能简陋到如今生态繁荣。很多新手在第一步“安装”上就卡住了网上教程要么年代久远要么语焉不详尤其是在Windows和Linux这两个主流平台上的差异常常让人一头雾水。今天这篇内容就是把我这些年反复安装、配置、踩坑的经验整理成一份超详细的“保姆级”教程。我的目标很明确让你无论用Windows还是Linux都能在半小时内从零开始成功跑起一个干净、可用的rAthena服务器并且理解每一步操作背后的逻辑而不是机械地复制命令。2. 安装前的核心准备环境与工具选型在动手下载任何文件之前充分的准备工作能避免你后续90%的莫名错误。这一步的核心是搭建一个正确的编译和运行环境。2.1 理解rAthena的运行依赖rAthena本质上是一个C语言编写的服务端程序它需要被编译成可执行文件才能运行。因此它的核心依赖是C/C编译器和相关的开发库。除此之外它还需要一个数据库来存储所有游戏数据如角色信息、物品、NPC脚本等最常用的是MariaDBMySQL的一个分支完全兼容且性能更优。所以我们的准备工作就围绕这两大块展开。为什么是MariaDB而不是其他数据库历史原因和社区生态决定了rAthena与MySQL/MariaDB的深度绑定。其数据库结构SQL文件、查询语句都是为MySQL语法优化的。虽然理论上可以通过修改源码适配其他数据库但这会引入巨大的复杂性和不稳定性对于新手和绝大多数应用场景而言直接使用MariaDB是最稳妥、最省事的选择。2.2 Windows平台环境准备在Windows上我们主要解决两个问题编译环境和数据库。1. 编译环境MSYS2 MinGW-w64早期教程可能让你装臃肿的Visual Studio或者老旧的Dev-C。现在最推荐的是MSYS2。它是一个在Windows上提供完整GNU工具链包括GCC编译器、Make、Git等的环境轻量且高效。通过它安装的MinGW-w64编译器能完美编译出原生Windows可执行文件.exe。安装步骤与要点访问MSYS2官网下载安装程序。安装路径强烈建议使用纯英文、无空格的短路径例如C:\msys64。这是为了避免后续编译时可能出现的各种路径解析错误。安装完成后从开始菜单打开MSYS2 UCRT64这个终端。注意MSYS2有多个终端MSYS, MINGW32, MINGW64, UCRT64我们选择UCRT64是因为它使用更新的运行时库兼容性更好。在终端中首先更新软件包数据库pacman -Syu。如果提示关闭终端就照做重新打开后再执行一次pacman -Su确保完全更新。安装编译rAthena所需的工具链pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain git。这个命令会安装GCC、G、Make、Git等一系列必备工具。2. 数据库环境MariaDB去MariaDB官网下载Windows安装程序.msi。安装过程中有几个关键点设置root密码务必设置一个强密码并牢记。不要留空。选择编码在字符集Character Set设置页面务必选择“utf8mb4”。这是为了完美支持所有语言字符包括emoji避免游戏内出现乱码。记住端口号默认是3306如果没被占用保持默认即可。安装完成后建议将MariaDB的bin目录如C:\Program Files\MariaDB 11.3\bin添加到系统的PATH环境变量中这样以后在任意命令行都可以使用mysql命令。注意有些一键安装包会捆绑HeidiSQL或phpMyAdmin这类数据库图形化管理工具。对于新手我强烈建议额外安装一个HeidiSQL。它比命令行直观太多用于创建数据库、导入SQL文件、执行查询等操作非常方便。2.3 Linux平台环境准备Linux下的准备相对统一主要通过包管理器完成。这里以最流行的Ubuntu 22.04 LTS及其衍生版如Debian为例。如果你用CentOS/RHEL系列命令会从apt换成yum或dnf但包名基本类似。打开你的终端依次执行以下命令# 1. 更新软件包列表 sudo apt update # 2. 安装编译工具和依赖库 sudo apt install -y build-essential cmake git libmariadb-dev-compat libmariadb-dev pkg-config zlib1g-dev # 3. 安装MariaDB服务器和客户端 sudo apt install -y mariadb-server mariadb-client # 4. 安全初始化MariaDB非常重要 sudo mysql_secure_installation执行mysql_secure_installation时它会引导你进行一系列安全设置设置root密码和Windows一样设一个强密码。移除匿名用户。禁止root远程登录通常选Y提高安全性。移除测试数据库。立即重载权限表。这些步骤能确保你的数据库基础环境是安全的。关于Linux发行版的选择对于生产环境稳定压倒一切因此推荐Ubuntu LTS或Debian Stable。对于只是想学习测试任何你熟悉的发行版都可以只需根据其包管理器安装上述对应软件包即可。不推荐使用过于前沿的滚动发行版可能会遇到依赖库版本不兼容的问题。3. 获取与编译rAthena源代码环境准备好后我们就可以获取最新的rAthena代码并把它变成可以运行的程序了。这一步两个平台的核心逻辑一致但操作细节不同。3.1 使用Git克隆源代码无论Windows在MSYS2 UCRT64终端里还是Linux我们都使用Git来获取代码。这是最佳实践便于后续更新。# 切换到你打算存放项目的目录例如家目录下的projects文件夹 cd ~ mkdir -p projects cd projects # 克隆rAthena的主仓库 git clone https://github.com/rathena/rathena.git cd rathena这个rathena文件夹就是我们的工作根目录里面包含了所有服务端源代码、配置文件、数据库脚本等。3.2 Windows平台编译详解在MSYS2 UCRT64终端中确保当前目录是rathena。配置编译选项 首先我们需要运行configure脚本。它会检测你的环境并生成对应的编译配置Makefile。./configure这个脚本会询问你一些问题大部分直接按回车选择默认值即可。但有几个关键点Enable 64-bit support?如果你的系统是64位的现在基本都是选yes。这能提高性能并允许服务器使用更多内存。Use PCRE2?这是正则表达式库用于脚本解析。选yes功能更强大。其他关于数据库、加密等的选项通常保持默认启用就好。执行编译 配置完成后直接输入make命令开始编译。make server这个make server命令会编译三个核心服务程序login-server登录服务器、char-server角色服务器、map-server地图服务器。这是标准的三服结构。 编译过程会持续几分钟你会看到大量滚动的输出信息。只要最后没有出现error: ...之类的致命错误并以类似[100%] Built target map-server的提示结束就说明编译成功了。编译结果位置 编译生成的可执行文件.exe位于rathena/目录下。你会看到login-server.exe,char-server.exe,map-server.exe以及一个重要的工具mapcache.exe。实操心得第一次编译时可能会因为网络问题导致某些依赖下载失败如PCRE2。如果./configure失败仔细看错误信息通常它会提示你缺少哪个包。回到MSYS2终端用pacman -Ss 包名搜索然后用pacman -S安装对应的mingw-w64-ucrt-x86_64-开头的开发包即可。3.3 Linux平台编译详解在Linux终端中步骤与Windows高度相似但更简洁。配置与编译cd ~/projects/rathena ./configure make server同样在./configure时根据提示选择64位支持和PCRE2。make server的过程和Windows一样。关键差异与注意事项权限问题编译生成的可执行文件在Linux下可能没有执行权限。编译完成后可以运行chmod x login-server char-server map-server来添加。依赖完整性如果编译报错提示找不到mysql.h或某个库通常是因为前面“环境准备”环节的依赖没装全。回顾3.3节确保libmariadb-dev-compat和libmariadb-dev这两个包已安装。系统服务对于生产环境你可能会希望服务器在系统启动时自动运行。这需要编写systemd服务单元文件但这属于进阶部署范畴本篇先确保能手动运行成功。4. 数据库的初始化与配置服务器程序编译好了但还没有“数据”。我们需要创建一个空的数据库并把rAthena所需的初始数据表结构、基础物品、怪物、技能信息等导入进去。4.1 创建数据库与用户首先登录到MariaDB。在Windows上你可以用HeidiSQL图形化操作或者用命令行。在Linux上我们主要用命令行演示因为这是通用技能。# 使用root用户登录MariaDB控制台 # Linux下可能需要sudo或者直接用系统root权限 sudo mysql -u root -p # 然后输入你之前设置的root密码 # 进入MySQL命令行后执行以下SQL语句-- 1. 创建一个专门用于rAthena的数据库名字通常叫ragnarok CREATE DATABASE ragnarok CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 2. 创建一个专门管理这个数据库的用户比直接使用root更安全 -- rathena_user是用户名your_strong_password_here请替换成你自己的密码 CREATE USER rathena_userlocalhost IDENTIFIED BY your_strong_password_here; -- 3. 授予这个用户对ragnarok数据库的全部权限 GRANT ALL PRIVILEGES ON ragnarok.* TO rathena_userlocalhost; -- 4. 让权限生效 FLUSH PRIVILEGES; -- 5. 退出MySQL控制台 EXIT;安全提醒务必把your_strong_password_here换成高强度密码并且记录下来。后面配置服务器时会用到。4.2 导入初始数据rAthena的sql-files目录里准备了丰富的SQL脚本。我们需要按顺序导入它们。回到终端或HeidiSQL的查询窗口确保当前目录在rathena下然后使用刚创建的用户导入数据# Linux/Windows(MSYS2)命令行方式 # 先切换到sql-files目录下的正确位置 cd sql-files # 主数据库结构。注意这里用的是main.sql不是logs.sql或item_db.sql等。 mysql -u rathena_user -p ragnarok main.sql # 会提示输入 rathena_user 的密码 # 导入基础物品数据库。rAthena提供了多种选择这里用最通用的“re”版。 mysql -u rathena_user -p ragnarok item_db/item_db_re.sql # 导入怪物数据库 mysql -u rathena_user -p ragnarok mob_db/mob_db_re.sql # 导入技能数据库 mysql -u rathena_user -p ragnarok skill_db/skill_db.sql # 根据需要导入其他数据如卡片、宠物等但以上四个是启动服务器的最低要求。导入顺序很重要必须先main.sql创建表结构再导入具体数据。item_db_re.sql和mob_db_re.sql中的“re”代表“Renewal”是RO后续更新的版本体系包含了更多新物品和怪物建议使用。常见问题如果导入时出现大量错误比如“Table already exists”可能是因为你重复执行了导入。在首次搭建时确保数据库ragnarok是空的。如果搞乱了最简单的方法是DROP DATABASE ragnarok;然后从头再来一遍创建和导入。5. 服务器核心配置文件详解数据库有了程序也有了现在需要让它们俩认识一下。这就是配置文件的作用。rAthena的配置文件都在rathena/conf/目录下我们需要修改其中几个关键文件。重要原则修改任何配置文件前先备份原文件例如把inter_athena.conf复制一份为inter_athena.conf.backup。5.1 数据库连接配置inter_athena.conf这个文件负责告诉char-server和map-server如何连接数据库。用文本编辑器如VS Code、Notepad不要用Windows自带的记事本可能编码有问题打开conf/inter_athena.conf。找到如下段落并进行修改// MySQL Login server login_server_ip: 127.0.0.1 login_server_port: 3306 login_server_id: rathena_user // 改为你创建的用户名 login_server_pw: your_strong_password_here // 改为该用户的密码 login_server_db: ragnarok // 数据库名 login_codepage:// MySQL Character server char_server_ip: 127.0.0.1 char_server_port: 3306 char_server_id: rathena_user // 同上 char_server_pw: your_strong_password_here // 同上 char_server_db: ragnarok // 同上// MySQL Map server map_server_ip: 127.0.0.1 map_server_port: 3306 map_server_id: rathena_user // 同上 map_server_pw: your_strong_password_here // 同上 map_server_db: ragnarok // 同上关键点ip地址保持127.0.0.1表示服务器和数据库在同一台机器。port保持3306除非你安装MariaDB时改了端口。id,pw,db这三项必须与你创建数据库和用户时设置的一致。5.2 服务器网络配置char_athena.conf与map_athena.conf这两个文件分别配置角色服务器和地图服务器的网络监听端口。conf/char_athena.conf:char_server_port: 6121这是角色服务器端口客户端会连接这个端口来读取角色列表、创建角色等。通常保持默认6121即可除非端口冲突。conf/map_athena.conf:map_server_port: 5121这是地图服务器端口游戏内所有实时交互移动、战斗、聊天都通过这个端口。通常保持默认5121。关于bind_ip配置文件中可能有bind_ip选项默认是0.0.0.0表示监听所有网络接口。如果你只想让服务器在本地运行仅供本机客户端连接可以改为127.0.0.1。如果希望局域网内其他电脑也能连接则需要保持0.0.0.0并确保防火墙放行了对应端口6121, 5121, 6900。5.3 客户端连接配置clientinfo.xml或packet_db这是最容易出错的一步。服务器需要知道客户端版本以便使用正确的通信协议封包版本。如果这里配置错误客户端将无法连接提示“服务器拒绝连接”或版本不符。对于较新版本的rAthena主要配置在db/packet_db.yml或db/packet_db.txt。你需要根据你使用的客户端如2022年、2023年客户端来设置正确的packet_ver值。更传统和直接的方法是修改clientinfo.xml但这种方式在现代客户端中可能被替代。我们以配置packet_db为例打开db/packet_db.yml。找到开头的ClientPacketsVersion:部分。你会看到很多以日期命名的条目如2022-09-07a、2023-03-15等。你需要知道你客户端对应的封包日期。一个常见的测试方法是先使用一个已知较旧的日期如2022-09-07a。在client: {}部分设置packet_ver: 2022-09-07a。如果不知道客户端日期可以去rAthena的Wiki或相关社区查找常见客户端的封包版本对应表。这是连接成功的关键。6. 启动服务器与首次运行测试激动人心的时刻到了我们将按顺序启动三个服务器程序。6.1 启动顺序与观察日志三个服务器必须按登录服务器 - 角色服务器 - 地图服务器的顺序启动因为它们之间有依赖关系。启动登录服务器 (login-server)Windows: 在文件管理器双击login-server.exe或MSYS2终端运行./login-server。Linux: 在终端运行./login-server。 你会看到一个命令行窗口弹出显示大量初始化信息最后停留在类似[信息]: 服务器正在监听端口 6900 ...的提示上。6900是登录服务器的默认端口。如果看到“监听”成功的消息且没有红色错误说明第一步成功。启动角色服务器 (char-server)打开一个新的终端或命令行窗口不要关闭login-server。Windows: 双击char-server.exe或在新的MSYS2终端运行./char-server。Linux: 新终端cd到rathena目录运行./char-server。 同样观察输出。它会连接数据库加载角色数据最后显示监听端口6121。注意看有没有数据库连接成功的提示。启动地图服务器 (map-server)再打开第三个终端或命令行窗口。Windows: 双击map-server.exe或运行./map-server。Linux: 运行./map-server。 这是最“热闹”的一个窗口。它会加载所有地图、NPC、怪物脚本信息滚动最快。最终会显示监听端口5121并提示所有地图服务器已就绪。如何判断启动成功三个窗口都没有崩溃退出并且分别显示login-server:Listening on port 6900 (IPv4)...char-server:Listening on port 6121 (IPv4)...map-server: 最后一行是[状态]: 服务器 主要 已就绪 (服务器 0 已启动)或类似信息。6.2 使用客户端进行连接测试你需要一个RO客户端通常是一个完整的游戏文件夹。将服务器提供的clientinfo.xml或sclientinfo.xml文件需要根据你的服务器配置生成或修改放入客户端的根目录覆盖原有文件。这个文件里包含了服务器的IP地址127.0.0.1和端口6900。然后运行客户端的登录器通常是ragexe.exe或一个定制的登录器。在登录界面输入账号密码首次登录时账号密码任意输入服务器会自动创建新账号。如果一切配置正确你应该能看到服务器列表选择后进入角色创建或游戏画面。踩坑实录第一次连接失败十有八九是packet_ver不对。如果连接时立刻断开或提示版本错误请回到第5.3节尝试更换packet_db.yml中的版本号。另一个常见原因是防火墙或杀毒软件阻止了程序联网请确保在防火墙中允许这三个.exeWindows或端口Linux通信。7. 常见问题排查与进阶技巧即使按照教程一步步来也可能会遇到问题。这里汇总一些经典故障和解决方法。7.1 启动时报错排查表错误现象可能原因解决方案make编译失败提示fatal error: xxx.h: No such file or directory缺少开发依赖库。Windows在MSYS2中用pacman -S安装对应的mingw-w64-ucrt-x86_64-xxx包。Linux用apt install安装对应的libxxx-dev包。服务器启动时崩溃提示Failed to connect to database数据库连接信息配置错误。1. 检查inter_athena.conf中的用户名、密码、数据库名。2. 确认MariaDB服务已启动Windows服务管理器Linuxsudo systemctl status mariadb。3. 确认用户有远程登录权限如果是非localhost连接。map-server启动时卡在loading NPC...或大量脚本错误NPC脚本语法错误或依赖的脚本文件缺失。1. 检查npc/目录下的脚本文件。2. 可能是自定义脚本问题暂时将npc/scripts_custom.conf中出错的脚本行注释掉行首加//。客户端能登录但看不到服务器列表login-server的clientinfo或封包版本与客户端不匹配。1. 确认客户端使用的clientinfo.xml内容正确IP和端口是127.0.0.1:6900。2. 确认packet_db.yml中的packet_ver与客户端匹配。客户端连接服务器后瞬间断开防火墙阻止了端口通信或者char/map-server的IP绑定设置错误。1. 检查防火墙设置放行6900, 6121, 5121端口。2. 检查char_athena.conf和map_athena.conf中的bind_ip如果是局域网连接应为0.0.0.0。游戏内显示乱码数据库字符集不是utf8mb4。重新创建数据库确保执行CREATE DATABASE ... CHARACTER SET utf8mb4 ...。重新导入SQL文件。7.2 性能优化与安全基础服务器跑起来后你可能会考虑让它更稳定、更安全。基础优化调整地图服务器进程数在map_athena.conf中可以设置map_server_count。如果你的机器是多核CPU可以将其设置为与物理核心数相同或稍少以充分利用多核性能。每个地图服务器进程会分担一部分地图的负载。调整怪物AI频率battle_athena.conf中的monster_active_time和player_active_time可以调整AI计算频率降低CPU占用但会影响游戏响应速度需要根据在线人数权衡。安全须知非常重要修改默认账号密码rAthena的SQL文件中可能包含默认的GM账号如admin。务必在数据库的login表里修改这些账号的密码使用SHA1哈希。限制数据库用户权限我们之前创建的rathena_user只对ragnarok数据库有权限且只能从localhost连接这已经是一个好习惯。绝对不要用root用户来运行游戏服务器。防火墙配置生产服务器必须配置防火墙只开放必要的端口6900, 6121, 5121给客户端22/3389给管理3306通常不对外开放。定期备份定期备份你的ragnarok数据库和rathena/conf、rathena/npc等自定义过的目录。数据库备份可以用mysqldump命令。7.3 后续维护与更新rAthena是一个活跃的开源项目定期会有bug修复和新功能加入。更新源代码cd ~/projects/rathena git pull origin master执行git pull会拉取最新的代码。注意更新后通常需要重新编译./configure make clean # 清理旧的编译文件 make server更新数据库 更新代码后务必检查sql-files目录下是否有新的升级脚本如upgrade_xxxx.sql。如果有需要按顺序执行它们来更新数据库结构mysql -u rathena_user -p ragnarok sql-files/upgrade_xxxx.sql警告在执行任何升级脚本前一定要先备份整个数据库。我个人在维护多个测试服时养成了一个习惯任何配置修改或版本更新前先为整个rathena目录和数据库创建一个带时间戳的备份。这个习惯让我在多次实验失败后能快速回滚节省了大量重装时间。对于刚上手的你我建议先在本地虚拟机或闲置电脑上反复练习整个安装和配置流程直到完全熟悉每一步的含义和可能出现的问题然后再部署到真正的服务器上。
)
