Skip to content

配置项与环境变量总表 ​

AIST 坚持极简配置面设计:客户端无业务配置文件,服务端无必填环境变量。

客户端环境变量 ​

变量名是否必填默认值说明
AIST_SERVER否token.json 中已存地址或 https://aistrun.cc覆盖 aist login、运行期请求与 run.sh 连接的服务端地址
AIST_RELEASE_BASE_URL否${AIST_SERVER}/releases/client仅 run.sh 使用,用于本地或自定义镜像源测试
AIST_YES否空仅 uninstall.sh 使用,设为 1 时在非交互环境免确认卸载
LC_ALL / LC_MESSAGES / LANG否系统默认仅在 ~/.aist/preferences.json 尚未生成时读取一次,用于首次自动推断默认语言(zh / en)

服务端与 Compose 环境变量 ​

变量名作用范围默认值说明
AIST_SERVER_ADDRserver 进程:8090服务端 HTTP 监听地址(容器内固定为 :8090)
AIST_SERVER_VERSIONdeploy/server/compose.yamllatestghcr.io/llaoj/aist-server 镜像标签
AIST_SERVER_BINDdeploy/server/compose.yaml127.0.0.1:8090宿主机绑定地址与端口
AIST_SERVER_DATAdeploy/server/compose.yaml./data挂载到容器 /var/lib/aist 的宿主机持久化目录
自定义 <变量名>server serve --encryptionEnv=<变量名>不启用可选 32 字符密钥,开启 PocketBase Settings 与 upstream_providers.api_key 的 AES-256-GCM 落盘加密

用户与邀请码 settings JSON 字段 ​

存放在服务端 users.settings 与 invite_codes.settings 中:

json
{
  "session": {
    "max_sessions": 10,
    "compaction": {
      "keep_tokens": 20000,
      "trigger_ratio": 0.85
    }
  },
  "blacklist": [
    "rm -rf /",
    "mkfs *",
    "shutdown"
  ]
}
字段省略或 <= 0 时的回退默认值说明
session.max_sessions10客户端本地保留的最近会话数量
session.compaction.keep_tokens20000触发上下文压缩时尾部保留的原始消息 Token 预算
session.compaction.trigger_ratio0.85当估算上下文达到 (context_window - max_output_tokens) × trigger_ratio 时触发压缩
blacklist[]同时注入系统提示词并在客户端通过 Shell AST 拦截的命令通配规则

客户端代理请求超时默认值 ​

超时项默认值
单次模型调用总超时10 分钟
等待响应头超时5 分钟
响应体读取超时15 分钟

基于 AGPL-3.0 协议开源(提供商业授权:[email protected])