wiva-hq/CodeRail

选用指南

AI 根据 README 整理 · 2026/11/1 07:52:11

适用场景

适合团队协作场景，支持为每台电脑分配Owner、Operator或Viewer角色，并审计所有变更。

查看 README 依据

<td width="33%" valign="top"><b>🔑 Your agents stay yours</b><br>_{Each computer runs its own <code>claude</code> and <code>codex</code> with its own login. CodeRail never holds AI keys.}</td> <td width="33%" valign="top"><b>👥 Built for teams</b><br>_{Owner, Operator or Viewer per computer, down to folders and agents. Every change is audited.}</td> </tr> <tr> <td valign="top"><b>💬 Agent chats</b><br>_{Claude Code and Codex over ACP: plans, tool calls, models, modes, background tasks.}</td>

使用方式

通过Docker容器在服务器上部署，然后在每台电脑上安装桥接程序（Mac或Linux），通过浏览器或手机访问。

查看 README 依据

ACP adapters, and serves terminals, files, git and the browser. The **server** checks every request against the person's role and keeps the history. ## Get started **1 · Run the server** on any machine with Docker, then put HTTPS in front of port 8080 ([details](https://docs.coderail.codes/self-hosting/deploy)): ```sh git clone https://github.com/wiva-hq/CodeRail && cd CodeRail cp .env.example .env # set SETUP_TOKEN docker compose up -d # the image from ghcr.io; everything it keeps is in ./data ```

The image is [`ghcr.io/wiva-hq/coderail`](https://github.com/wiva-hq/CodeRail/pkgs/container/coderail) (amd64 and arm64). Update with `git pull && docker compose pull && docker compose up -d`. **2 · Create the first admin** at `https://your-site/setup` with that token. **3 · Add a computer.** On a Mac: **Machines → Download for Mac** and approve the code. On Linux: ```sh curl -fsSL https://your-site/install.sh | sh ``` Every build is also on [Releases](https://github.com/wiva-hq/CodeRail/releases), with its checksums.

部署要求

服务器需安装Docker，电脑需运行macOS或Linux，需要HTTPS配置。

查看 README 依据

<a href="https://docs.coderail.codes"><img alt="Docs" src="https://img.shields.io/badge/docs-docs.coderail.codes-18181b?style=flat-square"></a> <a href="https://github.com/wiva-hq/CodeRail/pkgs/container/coderail"><img alt="Server: Docker" src="https://img.shields.io/badge/server-Docker-2496ed?style=flat-square&logo=docker&logoColor=white"></a> <img alt="Computers: macOS and Linux" src="https://img.shields.io/badge/computers-macOS%20·%20Linux-52525b?style=flat-square"> <img alt="Status: early" src="https://img.shields.io/badge/status-0.0.1%20early-f59e0b?style=flat-square">

ACP adapters, and serves terminals, files, git and the browser. The **server** checks every request against the person's role and keeps the history. ## Get started **1 · Run the server** on any machine with Docker, then put HTTPS in front of port 8080 ([details](https://docs.coderail.codes/self-hosting/deploy)): ```sh git clone https://github.com/wiva-hq/CodeRail && cd CodeRail cp .env.example .env # set SETUP_TOKEN docker compose up -d # the image from ghcr.io; everything it keeps is in ./data ```

已知限制

项目处于早期阶段（0.0.1 early），且未实现端到端加密，服务器会保留历史记录。

查看 README 依据

<a href="https://docs.coderail.codes"><img alt="Docs" src="https://img.shields.io/badge/docs-docs.coderail.codes-18181b?style=flat-square"></a> <a href="https://github.com/wiva-hq/CodeRail/pkgs/container/coderail"><img alt="Server: Docker" src="https://img.shields.io/badge/server-Docker-2496ed?style=flat-square&logo=docker&logoColor=white"></a> <img alt="Computers: macOS and Linux" src="https://img.shields.io/badge/computers-macOS%20·%20Linux-52525b?style=flat-square"> <img alt="Status: early" src="https://img.shields.io/badge/status-0.0.1%20early-f59e0b?style=flat-square">

Everything else (roles, the browser, phones, troubleshooting) is in the **[documentation](https://docs.coderail.codes)**. ## Security, in short Self-hosted, outbound-only computers, no AI credentials, invite-only accounts, permissions checked on the server and again on the computer, signed and notarized Mac builds. Not end-to-end encrypted: your server keeps the history. Read the [security model](https://docs.coderail.codes/reference/security); report vulnerabilities privately per [SECURITY.md](SECURITY.md). ## Development ```sh bun install