marketing-shibata50/9router

Fork 0

decolua fd92af77a0 Feat : Gitbook

2026-05-11 11:50:24 +07:00

8.1 KiB

Raw Blame History

Cài đặt

Hướng dẫn cài đặt chi tiết cho 9Router với mẹo troubleshooting.

Yêu cầu

Yêu cầu hệ thống

Node.js: Phiên bản 20.0.0 trở lên
npm: Phiên bản 10.0.0 trở lên (đi kèm Node.js)
OS: macOS, Linux, Windows (khuyên dùng WSL)
Dung lượng: ~200MB để cài đặt

Kiểm tra Phiên bản

node --version
# Should show v20.x.x or higher

npm --version
# Should show 10.x.x or higher

Chưa có Node.js? Cài đặt từ nodejs.org

Phương thức Cài đặt

Cách 1: Cài Global (Khuyên dùng)

Cài 9Router toàn cục để dùng ở bất kỳ đâu:

npm install -g 9router

Khởi động 9Router:

9router

Lợi ích:

✅ Chạy từ mọi thư mục
✅ Lệnh đơn giản: 9router
✅ Auto-update với npm update -g 9router

Cách 2: Cài Local

Cài trong project cụ thể:

mkdir my-9router
cd my-9router
npm install 9router

Khởi động 9Router:

npx 9router

Lợi ích:

✅ Cô lập mỗi project
✅ Version control mỗi project
✅ Không làm bẩn global namespace

Cách 3: Từ Source (Development)

Clone và build từ GitHub:

git clone https://github.com/decolua/9router.git
cd 9router/app
npm install
npm run build
npm start

Lợi ích:

✅ Tính năng phát triển mới nhất
✅ Đóng góp cho dự án
✅ Tùy chỉnh

Lần chạy Đầu tiên

Khởi động Server

9router

Điều gì xảy ra:

Server khởi động tại http://localhost:20128
Dashboard tự động mở trong browser
Data directory được tạo tại ~/.9router
API key được tạo tự động

Đăng nhập Dashboard

Credentials mặc định:

Mật khẩu: 123456

⚠️ Đổi mật khẩu ngay:

Đăng nhập dashboard
Settings → Change Password
Dùng mật khẩu mạnh

Lấy API Key

Dashboard → Settings → API Keys
→ Copy your API key
→ Use in CLI tools

Ví dụ format API key:

9r_1234567890abcdef1234567890abcdef

Xác minh Cài đặt

Kiểm tra trạng thái Server

curl http://localhost:20128/health

Phản hồi dự kiến:

{
  "status": "ok",
  "version": "1.0.0"
}

Liệt kê Model khả dụng

curl http://localhost:20128/v1/models \
  -H "Authorization: Bearer your-api-key"

Phản hồi dự kiến:

{
  "object": "list",
  "data": [
    {
      "id": "cc/claude-opus-4-5-20251101",
      "object": "model",
      "created": 1234567890,
      "owned_by": "claude-code"
    }
  ]
}

Test Chat Completion

curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cc/claude-opus-4-5-20251101",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Cấu hình

Biến môi trường

Tạo file .env hoặc set biến môi trường:

# Security (REQUIRED in production)
export JWT_SECRET="your-secure-secret-change-this"
export INITIAL_PASSWORD="your-password"

# Storage
export DATA_DIR="~/.9router"

# Server
export PORT="20128"
export NODE_ENV="production"

# Logging
export ENABLE_REQUEST_LOGS="false"

Data Directory

Vị trí mặc định: ~/.9router

Nội dung:

~/.9router/
  ├── db.json           # Database (providers, combos, usage)
  ├── api-keys.json     # API keys
  └── logs/             # Request logs (if enabled)

Đổi vị trí:

export DATA_DIR="/custom/path"
9router

Cấu hình Port

Port mặc định: 20128

Đổi port:

export PORT="3000"
9router

Hoặc dùng command line:

9router --port 3000

Troubleshooting

Port đã được dùng

Lỗi:

Error: listen EADDRINUSE: address already in use :::20128

Giải pháp 1: Kill process hiện có

# Find process using port 20128
lsof -i :20128

# Kill process
kill -9 <PID>

Giải pháp 2: Dùng port khác

9router --port 3000

Permission Denied

Lỗi:

Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/9router'

Giải pháp: Dùng sudo (không khuyến nghị) hoặc fix npm permissions

# Fix npm permissions (recommended)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Then install again
npm install -g 9router

Node.js Phiên bản quá cũ

Lỗi:

Error: The engine "node" is incompatible with this module

Giải pháp: Cập nhật Node.js

# Using nvm (recommended)
nvm install 20
nvm use 20

# Or download from nodejs.org

Dashboard không mở

Vấn đề: Dashboard không tự mở

Giải pháp 1: Mở thủ công

http://localhost:20128

Giải pháp 2: Kiểm tra firewall

# macOS: Allow Node.js in System Preferences → Security
# Linux: Check iptables
# Windows: Check Windows Firewall

Không kết nối được Provider

Vấn đề: OAuth login thất bại hoặc API key không hợp lệ

Giải pháp 1: Kiểm tra kết nối internet

ping google.com

Giải pháp 2: Kiểm tra trạng thái provider

Giải pháp 3: Tạo lại API key

Dashboard → Provider → Disconnect → Reconnect

Sử dụng RAM cao

Vấn đề: 9Router dùng quá nhiều RAM

Giải pháp: Khởi động lại server

# Stop
pkill -f 9router

# Start
9router

Hoặc dùng PM2 để auto-restart:

npm install -g pm2
pm2 start 9router --name 9router
pm2 save

Tùy chọn Deployment

Phát triển cục bộ

npm install -g 9router
9router

Use case: Code cá nhân, testing

VPS/Cloud Server

# Install
npm install -g 9router

# Configure
export JWT_SECRET="your-secure-secret"
export INITIAL_PASSWORD="your-password"
export NODE_ENV="production"

# Start with PM2
npm install -g pm2
pm2 start 9router --name 9router
pm2 save
pm2 startup

Use case: Team access, remote coding

Docker

docker pull 9router/9router:latest

docker run -d \
  -p 20128:20128 \
  -e JWT_SECRET="your-secure-secret" \
  -e INITIAL_PASSWORD="your-password" \
  -v 9router-data:/root/.9router \
  --name 9router \
  9router/9router:latest

Use case: Containerized deployment, Kubernetes

Reverse Proxy (Nginx)

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:20128;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        
        # SSE support for streaming
        proxy_buffering off;
        proxy_read_timeout 86400;
    }
}

Use case: HTTPS, custom domain, load balancing

Gỡ cài đặt

Gỡ Global Installation

npm uninstall -g 9router

Xóa Data Directory

rm -rf ~/.9router

Xóa Cấu hình

# Remove environment variables from shell config
nano ~/.bashrc  # or ~/.zshrc
# Delete 9router-related exports

Bước tiếp theo

Hướng dẫn Bắt đầu - Kết nối provider và bắt đầu code
Tính năng - Khám phá quota tracking, combos, deployment
Troubleshooting - Sửa các vấn đề thường gặp

Cần trợ giúp?

Website: 9router.com
GitHub: github.com/decolua/9router
Issues: github.com/decolua/9router/issues

8.1 KiB Raw Blame History

Cài đặt

Yêu cầu

Yêu cầu hệ thống

Kiểm tra Phiên bản

Phương thức Cài đặt

Cách 1: Cài Global (Khuyên dùng)

Cách 2: Cài Local

Cách 3: Từ Source (Development)

Lần chạy Đầu tiên

Khởi động Server

Đăng nhập Dashboard

Lấy API Key

Xác minh Cài đặt

Kiểm tra trạng thái Server

Liệt kê Model khả dụng

Test Chat Completion

Cấu hình

Biến môi trường

Data Directory

Cấu hình Port

Troubleshooting

Port đã được dùng

Permission Denied

Node.js Phiên bản quá cũ

Dashboard không mở

Không kết nối được Provider

Sử dụng RAM cao

Tùy chọn Deployment

Phát triển cục bộ

VPS/Cloud Server

Docker

Reverse Proxy (Nginx)

Gỡ cài đặt

Gỡ Global Installation

Xóa Data Directory

Xóa Cấu hình

Bước tiếp theo

Cần trợ giúp?

8.1 KiB

Raw Blame History