Cổng mô hình miễn phí OpenCode Zen, bản fork tiếng Việt của LAGcomcom/zen-gate. OpenKi chạy như một gateway cục bộ tương thích OpenAI/Anthropic, tự inject cấu hình vào các AI Agent đã cài trên máy. Linux/WSL là nền tảng chính; Windows và macOS dùng chung mã nguồn.
| Làn miễn phí | Đóng gói OpenCode Zen thành /v1/chat/completions, /v1/responses, /v1/messages; tự chuyển mô hình khi bị giới hạn. |
| Tự inject Agent | OpenCode, Codex, Claude Code, DeepSeek Harness, omp (Windows và WSL là hai mục riêng); sao lưu trước khi sửa, tắt là khôi phục. |
| Egress nhiều peer | relay, singbox, warp là các peer ngang hàng; mỗi request chọn một peer, lỗi transport hoặc 429/403 tự chuyển peer kế tiếp. |
| Pool tĩnh / xoay đăng ký | proxyPool cho http(s)/socks5(h)/direct; hoặc sidecar sing-box biến subscription thành pool socks và xoay mỗi request. |
| Hạn mức theo exit | 429 bắt đầu 90 giây, tăng dần đến 15 phút; governor token mỗi exit (mặc định 300k/phút, 0 = tắt). |
| Cache & thống kê | Prefix cache, ước tính quota ngày, heatmap 365 ngày, xuất CSV. |
| LAN có kiểm soát | API có thể mở cho LAN nhưng luôn cần API key; dashboard/admin chỉ chấp nhận loopback. |
| Cập nhật | Kiểm tra GitHub Releases; tự thay binary trên Windows, Linux hiển thị lệnh build/cài. |
Yêu cầu: Go ≥ 1.26, systemd trong WSL, user có quyền sudo.
git clone https://github.com/chipmax/OpenKi.git
cd OpenKi
CGO_ENABLED=0 go build -tags headless -trimpath -o openki ./cmd/openki
sudo install -m755 openki /usr/local/bin/openki
sudo install -m644 deploy/wsl/openki.service /etc/systemd/system/openki.service
sudo sed -i "s/User=admin/User=$USER/; s/Group=admin/Group=$USER/; s#/home/admin#$HOME#g" /etc/systemd/system/openki.service
sudo systemctl daemon-reload
sudo systemctl enable --now openkiMở http://127.0.0.1:8787 từ Windows (WSL2 mirrored networking) hoặc từ Linux.
Log: journalctl -u openki -f. Dữ liệu: $OPENKI_HOME (mặc định
~/.config/openki).
tools/build-linux.sh 2.0.0 # AppImage
tools/build-deb.sh 2.0.0 # Debian/Ubuntu .debBản desktop có tray; bản headless không cần GTK/WebView2.
Tải release tại chipmax/OpenKi/releases
hoặc build theo deploy/windows/README.md. Chạy một bản OpenKi trên một cổng;
không chạy đồng thời bản Windows và WSL nếu dùng chung cổng.
docker compose up -dCổng 8787, dữ liệu trong volume /data, healthcheck /healthz. Trang quản trị
luôn chỉ loopback; để truy cập từ xa dùng SSH tunnel hoặc reverse proxy cùng máy.
Cổng public chỉ nên là /v1/*, không phải /admin/*.
CGO_ENABLED=0 go build -tags headless -trimpath -o openki ./cmd/openki
go test ./...Kiểm tra fingerprint upstream: openki -gate-check (xem
docs/GATE-AB.md).
OpenKi kiểm tra feed GitHub Releases mỗi 6 giờ.
- Windows: trang Cập nhật có nút một chạm. Gateway tải
<asset>.sha256và manifest JSON có chữ ký Ed25519, xác minh cả hai trước khi đổi binary; thiếu hoặc sai là từ chối. Bản cập nhật được đổi chỗ nguyên tử và giữ bản cũ một lần khởi động để rollback. - Linux/macOS: trang Cập nhật hiển thị commit đang chạy và lệnh
git pull+ build + restart; không tự thay binary đang chạy. - Bản phát hành có
SHA256SUMScho mọi asset; kiểm tra bản tải tay bằngsha256sum -c SHA256SUMS. - Feed tùy chỉnh phải dùng HTTPS và publish
<asset>.sha256+ manifest đã ký.
Lịch sử thay đổi: CHANGELOG.md.
GNU GPL-3.0-only — SPDX: GPL-3.0-only. Toàn văn tại LICENSE.
- Mã nguồn gốc: LAGcomcom/zen-gate, Copyright (C) 2026 LAGcomcom.
- Bản fork: Copyright (C) 2026 chipmax.
- Khi phân phối lại phải kèm giấy phép, giữ thông báo bản quyền và cung cấp mã nguồn tương ứng.
- Thành phần bên thứ ba: THIRD_PARTY_NOTICES.md;
phần WARP có nguồn gốc GPL-3.0, xem
internal/warp/NOTICE.