文档 - Tron CLI 文档

概述

Server 模式让 Tron 作为 HTTP 服务运行，对外提供 RESTful API。这使得任何能发起 HTTP 请求的程序都可以调用 Tron 的 AI 能力，适合构建团队共享的 AI 服务、CI/CD 自动化流水线或与现有系统的集成。

服务遵循与 OpenAI API 兼容的接口规范，方便现有系统快速迁移接入。

启动服务

使用 tron server 命令启动 HTTP 服务：

终端

tron server --port 3000

Tron Server v0.2.1

监听地址: http://127.0.0.1:3000

认证方式: Bearer Token

工作目录: /home/user/project

就绪，等待请求...

也可以通过环境变量配置：

终端

TRON_SERVER_PORT=3000 TRON_SERVER_TOKEN=my-token tron server

API 参考

Server 模式提供以下主要 API 端点：

方法	路径	说明
`POST`	`/v1/chat`	发送消息，获取 AI 响应（支持流式）
`GET`	`/v1/sessions`	获取所有会话列表
`GET`	`/v1/sessions/:id`	获取指定会话详情及历史消息
`DELETE`	`/v1/sessions/:id`	删除指定会话
`GET`	`/v1/health`	服务健康检查

请求示例

使用 curl 调用 API：

bash

# 发送消息
curl -X POST http://localhost:3000/v1/chat \
  -H "Authorization: Bearer my-token" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "解释 src/api/auth.ts 中的认证逻辑",
    "sessionId": "session-001"
  }'

JSON 响应示例：

json

{
  "id": "msg-8f3a2b1c",
  "sessionId": "session-001",
  "content": "该文件使用 JWT Bearer 令牌认证...",
  "role": "assistant",
  "usage": {
    "inputTokens": 1842,
    "outputTokens": 356,
    "totalTokens": 2198
  },
  "createdAt": "2026-04-17T10:32:11Z"
}

认证

Server 模式使用 Bearer Token 认证。通过 --token 参数或环境变量 TRON_SERVER_TOKEN 设置令牌：

bash

# 方式一：命令行参数
tron server --token your-secret-token

# 方式二：环境变量
export TRON_SERVER_TOKEN=your-secret-token
tron server

客户端请求时在 HTTP 头中携带令牌：

bash

Authorization: Bearer your-secret-token

生产部署

推荐使用 Docker 部署 Tron Server：

dockerfile

# Dockerfile
FROM ubuntu:22.04

RUN apt-get update && apt-get install -y curl

# 安装 Tron
RUN curl -fsSL https://upgrade.lianwo123.com/troncode/cli/install | bash

WORKDIR /workspace

ENV TRONCODE_API_KEY=""
ENV TRON_SERVER_TOKEN=""
ENV TRON_SERVER_PORT=3000

EXPOSE 3000

CMD ["tron", "server", "--port", "3000"]

使用 nginx 作为反向代理，添加 HTTPS 和访问控制：

nginx

# nginx.conf 片段
server {
    listen 443 ssl;
    server_name tron.example.com;

    ssl_certificate /etc/ssl/certs/tron.crt;
    ssl_certificate_key /etc/ssl/private/tron.key;

    location /v1/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Authorization $http_authorization;
        proxy_set_header X-Real-IP $remote_addr;
        # 流式响应需关闭缓冲
        proxy_buffering off;
        proxy_cache off;
    }
}

⚠️

安全提示

生产环境中务必启用 HTTPS，并使用强随机令牌。Tron Server 拥有访问工作目录文件的权限，请确保部署环境的安全隔离。