Skip to content
chipmaxPublic

About

OpenKi - cổng mô hình miễn phí OpenCode Zen, bản fork tiếng Việt của zen-gate

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

OpenKi

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.

release go license

Tính năng

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.

Cài đặt

WSL / Debian / Ubuntu (khuyến nghị)

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 openki

Mở 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).

Linux desktop

tools/build-linux.sh 2.0.0       # AppImage
tools/build-deb.sh 2.0.0         # Debian/Ubuntu .deb

Bản desktop có tray; bản headless không cần GTK/WebView2.

Windows / macOS

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 / headless

docker compose up -d

Cổ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/*.

Build từ mã nguồn

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).

Cập nhật

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>.sha256 và 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ó SHA256SUMS cho mọi asset; kiểm tra bản tải tay bằng sha256sum -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.

Giấy phép

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.

About

OpenKi - cổng mô hình miễn phí OpenCode Zen, bản fork tiếng Việt của zen-gate

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages