馬上註冊，結交更多好友，享用更多功能，讓你輕鬆玩轉社區。
您需要 登入 纔可以下載或查看，沒有賬號？立即註冊
×
POPLAB 一鍵資料庫 v0.4.2 使用教學
免安裝 MariaDB・一鍵開服・伺服器設定・註冊網頁・玩家啟動器・自動更新・備份還原
這個工具可以幫你做什麼？
架設 rAthena 原本要自己安裝 MariaDB、建資料庫、匯入 SQL、改設定檔，步驟多又容易出錯。
POPLAB 一鍵資料庫把這些全部整合在一個視窗裡：
‧一鍵設定：自動準備 MariaDB（免安裝）、建立資料庫、匯入 SQL、設定連線
‧一鍵開服：啟動資料庫與伺服器
‧伺服器設定：經驗、掉寶、出生點、攻速、假人系統，不用改 TXT
‧註冊網頁：玩家用網頁自己註冊帳號
‧玩家啟動器：產生給玩家的啟動器，連線自動設定好，還能自動更新
‧備份還原、rAthena 更新後的 SQL 更新
POPLAB 伺服器 x64 完整包已經內建本工具（rathena\POPLAB-Database.exe），下載伺服器包就能直接用。
本工具免費提供，請勿付費購買。POPLAB 未授權任何人以官方名義販售本工具，請只從 poplab.tw 取得。
目錄
- 一、使用需求與放置位置｜二、第一次使用｜三、日常開服與關服
- 四、連線（單機／開服）｜五、伺服器設定｜六、註冊頁
- 七、客戶端：玩家啟動器與自動更新｜八、備份與還原｜九、SQL 更新
- 十、HeidiSQL 連線｜十一、紀錄與常見問題｜十二、資料夾、更新與搬移
一、使用需求與放置位置
| 項目 | 需求 | | 作業系統 | 64 位元 Windows | | 視窗元件 | Windows 內建的 WebView2（一般都有）；沒有時會改用 Edge 視窗 | | rAthena | 已編譯完成的 rAthena：根目錄有 runserver.bat、login-server.exe、char-server.exe、map-server.exe。使用 POPLAB 伺服器包就不用自己編譯 |
放置位置：POPLAB-Database.exe 要放在 rAthena 根目錄，和 conf、sql-files、runserver.bat 同一層，並保留 payload 資料夾（MariaDB 安裝套件）。POPLAB 伺服器包已經放好了。
自己的 rAthena：沒用 POPLAB 伺服器包也能用本工具，但要先用 Visual Studio 選 Release / x64 編譯成功，見 架設教學 第 9 章。工具放錯位置或還沒編譯時會提示你。
二、第一次使用（一鍵設定）
2-1. 開啟工具
先確認 RO 伺服器都已關閉，雙擊 POPLAB-Database.exe。第一次開啟會顯示免費提醒，按「我知道了」。
▲ 圖 1：第一次開啟的免費提醒
視窗操作：按住藍色標題列可以拖動視窗；右上角「─」縮小、「✕」關閉。
2-2. 選擇使用方式，按一鍵設定
| 選項 | 適合 | 說明 | | 單機自己玩 | 自己在同一台電腦玩 | 只有這台電腦能連；自動開啟遊戲內 _M/_F 註冊 | | 開服給別人玩 | 讓朋友從網路連進來 | 填玩家連得到的 IPv4 或網域（不要加 https:// 或連接埠） |
選好後按「✦ 一鍵設定資料庫」，等它完成。之後想改，可以到「連線」分頁。
▲ 圖 2：第一次使用：選擇單機或開服
2-3. 設定完成
看到「首次設定完成！」、狀態變成「● 資料庫執行中」就好了。畫面上的連接埠每套環境可能不同，以你的畫面為準。
▲ 圖 3：設定完成
一鍵設定會做的事：
‧準備 MariaDB，建立 ragnarok、ragnaroklog 資料庫
‧匯入 main.sql、web.sql、roulette_default_data.sql、logs.sql
‧設定 rAthena 的資料庫連線，並把伺服器內部帳號（s1/p1）換成隨機密碼
‧不會執行其他自訂 SQL；sql-files/upgrades 現有的更新檔視為已包含
2-4. 啟動伺服器
按「▶ 啟動伺服器」，會開出 login、char、map 三個黑色視窗。map-server 出現「Server is 'ready'」就可以開遊戲了。
▲ 圖 4：已開啟伺服器視窗
三、日常開服與關服
| 開服 | 開 POPLAB-Database.exe → 按「▤ 啟動資料庫」 → 按「▶ 啟動伺服器」 | | 關服 | 先關掉三個黑色視窗 → 再按「■ 停止資料庫」 |
▲ 圖 5：設定過的環境：資料都保留，按「啟動資料庫」即可
重要：
‧關服順序不能反過來，先關伺服器再停資料庫，否則可能遺失沒存檔的資料。
‧關掉工具視窗不會停止資料庫或伺服器；開了註冊頁的話，註冊頁也會繼續執行，直到停止資料庫。
‧伺服器已經在執行時，再按「啟動伺服器」不會重複開啟。
四、連線（單機自己玩／開服給別人玩）
到「⌁ 連線」分頁，可以隨時切換使用方式。
▲ 圖 6：單機自己玩（可勾選同時開啟 _M/_F 註冊）
▲ 圖 7：開服給別人玩
切換步驟：
- 先正常關閉所有 RO 伺服器。
- 選擇使用方式；開服要填玩家連得到的 IPv4 或網域，例如 play.example.com。
- 按「套用連線設定」，完成後重新開服。
說明：
‧套用前會自動備份設定，只改連線 IP，不會重新匯入 SQL，也不會清除帳號、角色。
‧單機模式只接受本機連線（127.0.0.1）；開服模式接受所有網路介面的連線。
‧工具不會設定路由器、防火牆和客戶端。開服還要：路由器轉發 TCP 6900、6121、5121（有註冊頁再加 8080），Windows 防火牆允許，並確認有公網 IP（CGNAT 共用 IP 外部連不進來）。詳見 架設教學 第 11 章。
‧登入、角色、地圖伺服器要在同一台電腦；跨電腦部署請不要用本功能。
‧不要對外開放資料庫的連接埠。
五、伺服器設定
「⚙ 伺服器設定」分頁可以直接調整常用設定，分成三組：
| 分組 | 可以設定 | | 基本 | 伺服器名稱、經驗倍率、掉寶倍率（一般／恢復／消耗／裝備／卡片／MVP，可「掉寶全部設為」一次改）、角色名稱可用中文、出生點、初始金錢與物品、_M/_F 註冊 | | 戰鬥與角色 | 攻速上限、詠唱時間、技能延遲、素質上限、特性素質上限、掉寶直接進背包、死亡經驗懲罰、寵物親密度與飢餓速度 | | 假人系統 | 總開關、總數上限（最多 1000）、各城鎮人數、擺攤、跟著真玩家練功等（伺服器有假人系統才會出現） |
▲ 圖 8：伺服器設定：基本（數值僅為示意）
▲ 圖 9：伺服器設定：假人系統（部分欄位示意）
生效方式：
‧戰鬥設定（倍率、攻速、素質、假人系統等）：遊戲內輸入 @reloadbattleconf 立即套用，或重開地圖伺服器。
‧角色、登入相關（伺服器名稱、出生點、初始物品、角色名稱、_M/_F 註冊）：要重新啟動伺服器。
‧倍率用「倍」顯示，1 倍＝原本；伺服器名稱只能用英文、數字（不能有空格）。
‧只寫入 conf/import 的 battle_conf.txt、char_conf.txt、login_conf.txt，原本的設定檔不動，修改前會備份到 POPLAB-Database/conf-backup。
六、註冊頁（玩家自己註冊帳號）
開服給別人玩時，可以開一個註冊網頁，玩家自己註冊遊戲帳號，不用 GM 一個一個開。
- 到「✉ 註冊頁」分頁，勾選「開啟註冊頁」。
- 填連接埠（預設 8080）、伺服器名稱、公告，以及下載客戶端、新手教學、Discord 連結（空白就不顯示）。
- 按「儲存註冊頁設定」。幾秒後狀態會顯示註冊頁網址，可以按「開啟註冊頁」測試。
▲ 圖 10：註冊頁設定
▲ 圖 11：玩家看到的註冊網頁
說明：
‧玩家用「連線分頁填的位址 + 連接埠」打開，例如 http://你的位址:8080/。單機模式只有這台電腦打得開。
‧帳號 4～23 個英文或數字、密碼 6～31 字元；同名帳號（不分大小寫）不能重複；有加法驗證題擋機器人。
‧同一個 IP 每天預設最多註冊 3 個（0＝不限制），每次成功後要等 30 秒。
‧註冊頁跟著資料庫開關：啟動資料庫時自動開啟，停止資料庫時一起關閉。
‧路由器要轉發這個連接埠；Windows 防火牆詢問時請允許 POPLAB-Database.exe。
‧註冊紀錄寫在 logs 資料夾，只記帳號與 IP，不記密碼。
七、客戶端：玩家啟動器與自動更新
用「◈ 客戶端」分頁做出給玩家的啟動器。玩家解壓縮到客戶端資料夾，就能直接連到你的伺服器。
7-1. 先完成的事
- 「連線」分頁選好使用方式（開服要填位址）。
- （選用）開啟註冊頁，啟動器會多一個「註冊帳號」按鈕。
- （選用）在「伺服器設定 → 基本」填伺服器名稱（英文、數字），桌面捷徑和伺服器清單會用這個名字；沒設定時用 POPLAB。
7-2. 產生啟動器
| 欄位 | 要填什麼 | | 遊戲主程式檔名 | 玩家客戶端裡開遊戲的 exe 檔名，只填檔名。使用 POPLAB 繁中客戶端 時是 POPLAB-2025-07-16_patched.exe | | 啟動器背景圖（選填） | 自己的 PNG／JPG 完整路徑，會自動縮放成 560×360（多的從中間裁掉）；按鈕固定在右半邊，背景右側請留空間。留空用 POPLAB 預設外觀 | | 包含淡入淡出開關 | 啟動器多一個「淡入淡出」按鈕。「你的客戶端資料夾」填客戶端位置，工具會把裡面的「有淡入淡出」「無淡入淡出」兩個資料夾一起打包 | | 提供更新下載 | 開服模式才能勾；勾了以後玩家每次開啟啟動器都會先下載更新（見 7-4） |
按「產生玩家啟動器」，會做出 POPLAB-Database\launcher\POPLAB-Launcher.zip 並開啟資料夾。每次產生會覆蓋舊的。
▲ 圖 12：客戶端分頁（數值僅為示意）
7-3. 發給玩家
- 把完整客戶端和 POPLAB-Launcher.zip 一起給玩家（完整客戶端很大，請用雲端硬碟）。
- 玩家把 POPLAB-Launcher.zip 解壓縮到客戶端資料夾並覆蓋，連線設定會自動換成你的伺服器。
- 之後用 POPLAB-Launcher.exe 開遊戲，帳號密碼在遊戲裡輸入。
▲ 圖 13：玩家啟動器：開始遊戲、註冊帳號、建立桌面捷徑、淡入淡出
說明：
‧改了連線位址、註冊頁或更新設定後，請重新產生並發給玩家。
‧淡入淡出切換前要先關閉遊戲；原本不同的檔案會先備份到「淡入淡出備份」，缺檔時按鈕會變灰色。
‧Avast 等防毒軟體可能誤判 POPLAB-Launcher.exe（Elurair 已知問題），請玩家加入例外。
‧啟動器 Elurair 由 Ai4rei/AN 製作（CC BY-NC 4.0，不可商業使用），壓縮檔裡的原作者授權與說明請勿刪除。
7-4. 自動更新（小更新）
- 把要更新的檔案放進一個新資料夾，照客戶端資料夾的結構擺好，例如 更新\data\…、更新\System\…。檔名不要用中文。
- 在檔案總管網址列複製這個資料夾的路徑，貼到「要加入更新的資料夾」，按「加入更新」。
- 工具會壓縮成伺服器根目錄 patch 資料夾裡的 poplab_update_001.zip、002…，玩家下次開啟啟動器就會下載。
注意：
‧已經發出的更新不要刪改；要修正就再加一個新的更新。
‧一次最多 1 GB，大的更新請用雲端硬碟。
‧更新和註冊頁用同一個連接埠，路由器要轉發；資料庫停止時更新也會停。
‧連不到伺服器時玩家仍可開始遊戲，下次開啟再試。
‧patch 資料夾只放工具產生的更新檔，不要放其他東西。
八、備份與還原
8-1. 備份
先關閉 RO 伺服器，保持資料庫啟動，到「▣ 備份」分頁按「立即備份」。按「開啟備份資料夾」可以看到備份檔（backups 資料夾）。
▲ 圖 14：備份與還原（檔名僅為示意）
8-2. 還原
選要還原的備份 → 按「還原備份」→ 確認視窗按「備份後還原」。工具會先自動備份目前資料，再套用你選的備份。
▲ 圖 15：還原前的確認
建議：開放玩家前、改大量設定前、更新 rAthena 前，各備份一次。
還原失敗時請保留備份與紀錄，處理完成前不要繼續開服。備份檔含所有帳號資料，請妥善保存。
九、rAthena 更新後的 SQL 更新
用 git 更新 rAthena 後，如果 sql-files/upgrades 多了新的 upgrade_*.sql，「啟動」頁會出現提醒。
▲ 圖 16：偵測到新的 SQL 更新（檔名僅為示意）
- 先正常關閉 RO 伺服器。
- 按「套用 SQL 更新」。工具會先備份，再依日期順序套用；檔名結尾是 _logs 的會套用到 ragnaroklog。
- 看到「SQL 更新已全部套用，可以啟動伺服器。」就完成了。
套用失敗時會停在失敗的檔案，並顯示 MariaDB 錯誤訊息，可以到「備份」頁還原剛才的備份。
十、用 HeidiSQL 查看資料
| 欄位 | 填入 | | 網路類型 | MariaDB 或 MySQL（TCP/IP） | | 主機 | 127.0.0.1 | | 使用者 | root | | 密碼 | 用記事本開 POPLAB-Database\client.ini，複製 password= 後面的內容 | | 連接埠 | 工具主畫面顯示的數字（不一定是 3306） |
連線時資料庫要在執行中。ragnarok 是帳號與角色資料，ragnaroklog 是遊戲紀錄。
client.ini、state.json、register-client.ini 含資料庫密碼，請勿公開分享。
十一、執行紀錄與常見問題
遇到問題先看「▤ 紀錄」分頁，按「開啟紀錄資料夾」可以找到紀錄檔。
▲ 圖 17：執行紀錄
Q：顯示「找不到 runserver.bat」或「rAthena 尚未編譯完成」？
A：工具不在 rAthena 根目錄，或 rAthena 還沒編譯成功。
Q：首次設定中途失敗？
A：再按一次「一鍵設定」重試。沒完成的資料夾會改名成 POPLAB-Database-failed-日期時間保留，確認新設定正常後可自行刪除。
Q：顯示「資料庫連接埠被其他程式占用」？
A：有另一套 MariaDB／MySQL 正在用同一個連接埠，請先關掉那個程式或服務。
Q：顯示「MariaDB 啟動逾時」或「資料庫連線或 SQL 執行失敗」？
A：請看 POPLAB-Database\data\mariadb-error.log 的錯誤訊息。
Q：顯示「工具連線已中斷，請重新開啟 EXE」？
A：背景程式已結束，重新開啟 POPLAB-Database.exe 即可，資料庫和伺服器不受影響。
Q：首次設定顯示「下載失敗」？
A：payload 資料夾不見了，工具改用網路下載失敗。請重新解壓縮、保留 payload，再按一次一鍵設定。
Q：更新工具後提示要修復連線設定？
A：先關閉 RO 伺服器，再按「啟動資料庫」等待完成，原有 IP、倍率與自訂設定都會保留。
Q：玩家打不開註冊頁、啟動器連不上？
A：確認「連線」分頁是開服模式、位址正確，路由器轉發了 6900、6121、5121 和註冊頁連接埠，防火牆有允許。
回報問題：到 RO 私服疑問區 發帖，附上「紀錄」分頁的錯誤訊息與操作步驟。不要附上密碼、client.ini、state.json。
十二、資料夾、更新與搬移
| 位置（rAthena 根目錄下） | 內容 | | POPLAB-Database\ | 資料庫環境與資料（data 是帳號、角色資料），更新時請保留 | | POPLAB-Database\conf-backup\ | 修改前的連線與伺服器設定備份 | | POPLAB-Database\launcher\ | 產生的 POPLAB-Launcher.zip | | backups\ | SQL 備份檔 | | logs\ | 操作、錯誤與註冊紀錄 | | patch\ | 自動更新檔，玩家會下載這裡的檔案 | | config\ | 連線、註冊頁、啟動器設定 | | payload\ | MariaDB 安裝套件 |
更新工具：關閉舊工具 → 用新版 POPLAB-Database.exe 取代 → 保留上面的資料夾，不需要重新初始化 → 開啟後到「連線」分頁確認模式。
搬移或改名：先關伺服器、停止資料庫，再把整套 rAthena 資料夾一起搬；裡面的資料夾名稱與結構不要改。每套伺服器用各自的工具和資料，不要混用。
關於
「ⓘ 關於」分頁可以看版本與官方網站。本工具以 GPL-3.0 授權免費提供。
▲ 圖 18：關於
相關文章：
|
發表於 2026-10-27 18:06:33