7. Sao lưu & cài lại máy

7.1. Dữ liệu cần sao lưu

Nội dung	Đường dẫn	Chứa bí mật	Chia sẻ được
Cấu hình opencode	~/.config/opencode/opencode.json	Không	Có
Dữ liệu 9router: key và token của provider, cơ sở dữ liệu, khoá ký phiên đăng nhập	%APPDATA%\9router	Có	Không
API key của 9router	Trình quản lý mật khẩu	Có	Không
File tự khởi động	shell:startup\9router.vbs	Không	Có, sau khi kiểm tra đường dẫn

Thư mục 9router chứa bí mật

%APPDATA%\9router chứa key và token của provider. Không gửi thư mục này qua chat hay email, không lưu trên ổ đĩa dùng chung và không đưa vào Git.

Sao lưu dữ liệu 9router. Dừng 9router trước theo bước 2 ở 5.4, sau đó chạy trong PowerShell:

$dest = Join-Path $env:USERPROFILE "9router-backup-$(Get-Date -Format yyyy-MM-dd).zip"
Compress-Archive -Path "$env:APPDATA\9router" -DestinationPath $dest

Chuyển file zip sang nơi lưu trữ có mã hoá, ví dụ ổ đĩa BitLocker hoặc kho tệp của trình quản lý mật khẩu. Sau đó xoá bản trên máy.

7.2. Khôi phục sau khi cài lại máy

1. Cài Node.js theo 2.2.

2. Cài 9router bằng npm install -g 9router. Chưa chạy 9router.

3. Khôi phục dữ liệu 9router. File zip có thư mục gốc là 9router:

   Expand-Archive -Path "<đường-dẫn-file-zip>" -DestinationPath $env:APPDATA

4. Chạy 9router, mở dashboard và xác nhận provider cùng API key vẫn còn. Nếu không có bản sao lưu, kết nối lại provider và tạo key mới theo 2.3.

5. Đặt biến môi trường theo 2.4. Tạo lại file tự khởi động theo 2.3.1.

6. Cài opencode theo 2.5. Chép lại opencode.json, hoặc tạo mới theo 3.2.

7. Chạy toàn bộ 4. Kiểm tra.

7.3. Thành viên mới trong team

1. Gửi link tài liệu này và file opencode.json. File này không chứa key.
2. Mỗi người tự cài theo 2. Cài đặt, tự kết nối provider bằng tài khoản của mình và tự tạo API key.
3. Nếu team dùng chung một 9router trên server, quản trị viên tạo key riêng cho từng người. Mỗi người đổi baseURL theo mục mẹo ở 3.3.
4. Không sao chép thư mục dữ liệu 9router của người khác.

7.4. Quay lại cấu hình cũ

Khôi phục bản sao lưu đã tạo ở 3.1. Thay YYYY-MM-DD bằng ngày sao lưu:

Git Bash

cp -p ~/.config/opencode/opencode.json.bak-YYYY-MM-DD ~/.config/opencode/opencode.json
opencode service restart

PowerShell

$cfg = "$env:USERPROFILE\.config\opencode\opencode.json"
Copy-Item "$cfg.bak-YYYY-MM-DD" $cfg -Force
opencode service restart

Hoặc tắt tự đồng bộ và khai báo model thủ công trong khối providers.9router:

"9router": {
    "name": "9Router",
    "package": "aisdk:@ai-sdk/openai-compatible",
    "settings": {
        "apiKey": "{env:NINE_ROUTER_KEY}",
        "baseURL": "http://127.0.0.1:20128/v1",
        "modelsDiscovery": { "enabled": false }
    },
    "models": {
        "oc/deepseek-v4.1-flash-free": { "name": "DeepSeek V4.1 Flash (free)" }
    }
}