> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> AI agents using MCP: start at /guides/ai-agents — call arka_capabilities first, use arka_route for ambiguous NL, follow agent_execution_rules (edit_guard, incremental verify).
> Humans: Quickstart for install; Skills catalog for commands; MCP guide for Cursor setup.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# 将编码技能部署到 Railway

> 以安全的托管配置文件在 Railway 上托管 Arka 的编码/开发工具技能。

Arka 可以在 Railway 上运行一个仅编码用途的托管 API。此配置文件面向仓库/
开发工具工作流，例如 repo health、CI、PR 上下文、路由审计、审查、仓库图
以及 GitHub Actions 检查。桌面/媒体/个人类技能保持禁用。

## 部署的内容

Railway 配置文件使用：

* `Dockerfile`
* `railway.toml`
* `ARKA_REMOTE_PROFILE=coding`
* `ARKA_HOSTED_MODE=1`
* `ARKA_MCP_ENABLE_PERSONAL_SKILLS=0`

HTTP API 暴露：

| 端点               | 用途                 |
| ---------------- | ------------------ |
| `GET /v1/health` | 健康检查               |
| `POST /v1/agent` | 运行一次托管安全的编码/开发工具请求 |

## 部署

安装并认证 Railway CLI：

```bash theme={null}
npm i -g @railway/cli
railway login
```

从此仓库创建一个 Railway 项目：

```bash theme={null}
railway init
railway up
```

或通过 Arka 预览：

```bash theme={null}
arka deploy --platform railway --json
arka deploy --platform railway --yes
```

## 必填变量

在 Railway Variables 中设置：

```bash theme={null}
ARKA_HOSTED_MODE=1
ARKA_REMOTE_PROFILE=coding
ARKA_MCP_ENABLE_PERSONAL_SKILLS=0
REMOTE_HOST=0.0.0.0
REMOTE_TOKEN=<long-random-token>
```

在本地生成 token：

```bash theme={null}
python - <<'PY'
arka "import secrets"
arka "print(secrets.token_urlsafe(32))"
arka "PY"
```

可选的服务提供商/集成密钥：

```bash theme={null}
OPENAI_API_KEY=...
OPENROUTER_API_KEY=...
GITHUB_TOKEN=...
```

## 调用托管 API

```bash theme={null}
curl -sS "$RAILWAY_URL/v1/health"

curl -sS "$RAILWAY_URL/v1/agent" \
  -H "Authorization: Bearer $REMOTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"check repo health","remote_speak":false}'
```

或使用 Arka 的终端客户端：

```bash theme={null}
export ARKA_BACKEND_URL="$RAILWAY_URL"
export ARKA_BACKEND_TOKEN="$REMOTE_TOKEN"

arka backend status
arka backend ask "hi"
arka backend ask "init https://github.com/org/repo as a workspace"
arka backend ask "check repo health"
arka backend media ./recordings/bug.png
```

对于私有 GitHub 仓库，请在 Railway 上设置 `GH_TOKEN` 或 `GITHUB_TOKEN`
并重新部署。本地终端用户可以用 `gh auth login` 完成 GitHub 认证。

编码配置文件仅允许开发者安全的技能头，例如 `repo_health`、
`lint_project`、`pr_check`、`review`、`route_audit`、`ci`、`github_actions`、
`repo_context`、`repo_map`、`repo_graph`、`workspace`、`structure`、
`security`，以及插件/技能检查命令。

如果请求路由到桌面/媒体/个人类技能，服务器会拦截该请求并返回允许的能力
列表。


## Related topics

- [n8n 工作流自动化](/cn/guides/n8n.md)
- [将 Arka 部署到云与 Web 平台](/cn/guides/deploy.md)
- [AI 智能体指南 — 通过 MCP 使用 Arka](/cn/guides/ai-agents.md)
- [Arka 与其他智能体的对比](/cn/concepts/comparison.md)
- [托管模式](/cn/guides/hosted-mode.md)