docs: Refine README for pure Go engine and add SETUP_CERTS.cmd

This commit is contained in:
CAtlas0784 committed 2026-10-29 03:55:19 +07:00
1 parent dab553d4a2
commit 6cf3abfafe
3 files changed
+34 -23

No files matched your search

+21 -23
View File
@@ -1,43 +1,37 @@
# Ananta (Project Mugen) CBT 4229938 Private Server & Proxy Engine
# Ananta (Project Mugen) CBT 4229938 Private Server
เซิร์ฟเวอร์ส่วนตัว (Private Server) และระบบ HTTPS/SNI Proxy สำหรับเกม **Ananta (Project Mugen / 代号:无限大)** ไคลเอนต์เวอร์ชัน **CBT 4229938** พัฒนาขึ้นมาทั้งในรูปแบบ **High-Performance Native Go Engine (`ananta-server.exe`)** และ Clean Architecture C# .NET 8 ร่วมกับ Node.js Proxy เพื่อจำลองการเชื่อมต่อและเล่นเกมในโหมด Sandbox / Free-Roam ได้อย่างสมบูรณ์แบบ รองรับทั้งการเข้าเล่นผ่าน PC และ Mobile APK
เซิร์ฟเวอร์ส่วนตัว (Private Server) และระบบ Gateway Proxy สำหรับเกม **Ananta (Project Mugen / 代号:无限大)** ไคลเอนต์เวอร์ชัน **CBT 4229938** พัฒนาขึ้นมาด้วย **Native Go Engine (`ananta-server.exe`)** ประสิทธิภาพสูง เบา กินแรมน้อย และรันได้ในไฟล์เดียว (Single Binary) เพื่อจำลองการเชื่อมต่อและเล่นเกมในโหมด Sandbox / Free-Roam ได้อย่างสมบูรณ์แบบ รองรับทั้งการเข้าเล่นผ่าน PC และ Mobile APK
> 📖 **รายการระบบและฟีเจอร์ทั้งหมดของเซิร์ฟเวอร์ (36+ ระบบ)**: ดูรายละเอียดเชิงลึกและสถานะฟีเจอร์ทั้งหมดได้ที่ [docs/FEATURES.md](docs/FEATURES.md)
> 📖 **รายการระบบและฟีเจอร์ทั้งหมดของเซิร์ฟเวอร์**: ดูรายละเอียดเชิงลึกและสถานะฟีเจอร์ทั้งหมดได้ที่ [docs/FEATURES.md](docs/FEATURES.md)
---
## 🛠️ ความต้องการของระบบ (Prerequisites)
### สำหรับ Go Native Engine (แนะนำ - รันได้ทันทีโดยไม่ต้องลงรันไทม์เพิ่ม):
1. **Windows 10 / 11 (64-bit)**
2. ตัวเกม **Ananta / Project Mugen (CBT Client build 4229938 หรือ Mobile APK 4063976)**
3. (ตัวเลือกเสริมสำหรับการพัฒนา) **Go 1.22+**: [ดาวน์โหลดที่นี่](https://go.dev/dl/)
### สำหรับ C# / Node.js Engine ดั้งเดิม:
1. **.NET 8.0 SDK** & **Node.js (v18+)**
3. (ตัวเลือกเสริมสำหรับการพัฒนา/คอมไพล์) **Go 1.22+**: [ดาวน์โหลดที่นี่](https://go.dev/dl/)
---
## 🚀 วิธีติดตั้งและเปิดใช้งานเซิร์ฟเวอร์
### 1. ติดตั้ง Certificate & Hosts
รันคำสั่งด้วย PowerShell (Administrator) เพื่อชี้โดเมน NetEase เข้าหาเซิร์ฟเวอร์เครื่องคุณ (`127.0.0.1`):
```powershell
powershell -ExecutionPolicy Bypass -File .\Ananta.Proxy\SETUP_PROXY_AS_ADMIN.ps1
### 1. ติดตั้ง Root Certificate
คลิกขวาที่ไฟล์ `SETUP_CERTS.cmd` แล้วเลือก **Run as administrator** เพื่อติดตั้งใบรับรองความปลอดภัย Local Root CA:
```cmd
SETUP_CERTS.cmd
```
### 2. เปิดเซิร์ฟเวอร์ด้วย Go Engine (รวดเร็ว, น้ำหนักเบา, รวมทุกระบบในไบนารีเดียว)
### 2. เปิดเซิร์ฟเวอร์
ดับเบิลคลิกเปิดใช้งานผ่าน:
```cmd
START-GO.cmd
START.cmd
```
หรือรันผ่านคอมมานด์ไลน์:
```bash
.\ananta-server.exe
```
*(หรือหากต้องการใช้งาน C# Engine ดั้งเดิม สามารถดับเบิลคลิก `START.cmd` ได้เช่นกัน)*
เมื่อขึ้นข้อความ `[READY]` แสดงว่าระบบพร้อมทำงาน:
* **HTTPS Gateway Proxy**: พอร์ต 443 (TLS SNI) / 80 (HTTP) และ Mobile Dispatch พอร์ต 5801
* **Game Server**: Login Ports 5200, 5201 และ World Port 5202
@@ -49,7 +43,7 @@ START-GO.cmd
* **Mobile (APK):** ชี้เกตเวย์หรือรันผ่าน Wi-Fi Proxy มายัง IP เครื่องเซิร์ฟเวอร์ (พอร์ต 5801/443)
### 4. แผงควบคุมผ่านเว็บเบราว์เซอร์
* **GM Admin Panel**: [http://127.0.0.1:17888/](http://127.0.0.1:17888/) — จัดการไอเทม, วาร์ปพิกัด, สลับตัวละคร, และระบบโลก
* **GM Admin Panel**: [http://127.0.0.1:17888/](http://127.0.0.1:17888/) — จัดการไอเทม, วาร์ปพิกัด, สลับตัวละคร, เสกรถ, มอนสเตอร์ และระบบโลก
* **Debug WebUI Panel**: [http://127.0.0.1:5809/](http://127.0.0.1:5809/) — มอนิเตอร์การเชื่อมต่อ, เซสชันแบบ Real-Time, และ RPC Inspector
---
@@ -64,16 +58,20 @@ Ananta-ps/
│ ├── config/ # ตัวโหลดคอนฟิก private-server.json
│ ├── gateway/ # HTTPS/SNI Proxy (443), HTTP (80) และ Mobile Dispatch (5801)
│ ├── logingate/ # Login & Gate TCP Server (พอร์ต 5200, 5201)
│ ├── gameserver/ # World Entry (V7 handoff), Combat, Movement, Switching (5202)
│ ├── gameserver/ # World Entry, Traffic, Police, Combat, Mini-games, Racing, Teleport
│ └── web/ # GM Admin Panel (17888) และ Debug WebUI (5809)
├── pkg/
│ ├── crypto/chacha8/ # NetEase UXChaCha8 Custom Sigma Stream Cipher
│ └── protocol/ # Binary Serializer/Deserializer, Frame Codec, Key Exchange
│ └── protocol/ # Binary Serializer/Deserializer, Frame Codec, Key Exchange, Method Catalog
├── data/
│ └── player_info_template.bin # เทมเพลตข้อมูลผู้เล่นและไอเทมเริ่มต้น
├── config/ # private-server.json และตารางพิกัดมินิเกม/การจราจร
├── docs/ # FEATURES.md (ฟีเจอร์แมทริกซ์ 36 ระบบ)
├── START-GO.cmd # รัน Go Engine ทันทีในคลิกเดียว
│ ├── player_info_template.bin # เทมเพลตข้อมูลผู้เล่นและไอเทมเริ่มต้น
│ └── client_data/ # สถิติและคอนฟิกเกมเพลย์จาก Client CBT 4229938
├── certs/ # SSL/TLS Root CA และ Server Certificates
├── public/ # Patch Manifests และ Fastpatch Assets
├── config/ # private-server.json คอนฟิกเซิร์ฟเวอร์
├── docs/ # FEATURES.md (เอกสารฟีเจอร์และระบบทั้งหมด)
├── START.cmd # รัน Go Engine ทันทีในคลิกเดียว (คอมไพล์อัตโนมัติหากยังไม่มี exe)
├── SETUP_CERTS.cmd # ติดตั้ง Root Certificate ด้วยคำสั่งเดียว
└── ananta-server.exe # Single Native Binary Executable
```
+13
View File
@@ -0,0 +1,13 @@
@echo off
setlocal
cd /d "%~dp0"
echo [SETUP] Installing Ananta local root CA certificate...
certutil -addstore -f "Root" "certs\Ananta-local-root.cer"
if errorlevel 1 (
echo [ERROR] Failed to install certificate. Please run as Administrator.
pause
exit /b 1
)
echo [OK] Root certificate installed successfully.
pause
exit /b 0
BIN
View File
Binary file not shown.