Feat : Gitbook

gitbook/content/vi/deployment/localhost.md

@@ -0,0 +1,164 @@
+# 🏠 Triển khai Localhost
+
+Chạy 9Router trên máy cá nhân để phát triển và dùng cá nhân.
+
+---
+
+## 📦 Cài đặt
+
+Cài đặt 9Router toàn cục qua npm:
+
+```bash
+npm install -g 9router
+```
+
+**Yêu cầu:**
+- Node.js 20 trở lên
+- npm 9 trở lên
+
+---
+
+## 🚀 Khởi động Server
+
+Khởi động 9Router với một lệnh duy nhất:
+
+```bash
+9router
+```
+
+Dashboard sẽ tự động mở trong trình duyệt tại `http://localhost:3000`
+
+**Cấu hình mặc định:**
+- **Dashboard**: `http://localhost:3000`
+- **API Endpoint**: `http://localhost:20128/v1`
+- **Data Directory**: `~/.9router`
+
+---
+
+## 🔧 Cấu hình
+
+### Custom Data Directory
+
+Đặt thư mục data tùy chỉnh qua biến môi trường:
+
+```bash
+DATA_DIR=/path/to/data 9router
+```
+
+### Custom Port
+
+Port API (20128) và port dashboard (3000) được cấu hình trong application. Để đổi, bạn cần sửa source code hoặc dùng biến môi trường nếu được hỗ trợ.
+
+---
+
+## 🛑 Dừng Server
+
+Nhấn `Ctrl+C` trong terminal đang chạy 9Router.
+
+```bash
+# In the terminal running 9router
+^C  # Press Ctrl+C
+```
+
+Server sẽ shutdown an toàn và lưu mọi dữ liệu.
+
+---
+
+## 🔄 Khởi động lại Server
+
+Chỉ cần chạy lệnh start lại:
+
+```bash
+9router
+```
+
+Mọi cấu hình, API keys và combos được giữ lại trong thư mục data.
+
+---
+
+## 📊 Cập nhật 9Router
+
+Cập nhật phiên bản mới nhất:
+
+```bash
+npm update -g 9router
+```
+
+Kiểm tra version hiện tại:
+
+```bash
+npm list -g 9router
+```
+
+---
+
+## 🔍 Troubleshooting
+
+### Port đã được dùng
+
+Nếu port 20128 hoặc 3000 đã được dùng:
+
+```bash
+# Find process using the port (macOS/Linux)
+lsof -i :20128
+lsof -i :3000
+
+# Kill the process
+kill -9 <PID>
+```
+
+### Lỗi Permission
+
+Nếu gặp lỗi permission khi cài đặt:
+
+```bash
+# Use sudo (not recommended)
+sudo npm install -g 9router
+
+# Or fix npm permissions (recommended)
+mkdir ~/.npm-global
+npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Vấn đề Data Directory
+
+Nếu thư mục data không truy cập được:
+
+```bash
+# Check permissions
+ls -la ~/.9router
+
+# Fix permissions
+chmod 755 ~/.9router
+```
+
+---
+
+## 📁 Cấu trúc Data Directory
+
+```
+~/.9router/
+├── db.json           # Main database (providers, combos, settings)
+├── logs/             # Application logs
+└── cache/            # Temporary cache files
+```
+
+**Backup Data:**
+
+```bash
+# Backup
+cp -r ~/.9router ~/.9router.backup
+
+# Restore
+cp -r ~/.9router.backup ~/.9router
+```
+
+---
+
+## 🔗 Bước tiếp theo
+
+- [Kết nối Providers](/providers/subscription.md)
+- [Tạo Combos](/features/combos.md)
+- [Tích hợp với CLI Tools](/integration/cursor.md)