> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 不同网络环境下连接 APIONE

> 排查本机、代理、容器和远程服务中的连接问题。

## 先区分三层设置

| 层级 | 作用 | 示例 |
| - | - | - |
| 模型端点 | 指定请求目标 | [https://api.apione.ai/v1](https://api.apione.ai/v1) |
| 网络代理 | 指定请求经过的网络出口 | 本机代理或企业代理 |
| 工具与沙箱权限 | 控制 Agent 执行命令和访问资源 | 项目目录、网络访问授权 |

修改 Base URL 不会自动配置代理，模型连接成功也不代表 Agent 的工具具备网络权限。

## 从实际运行环境检查

在运行客户端的同一终端设置 APIONE\_API\_KEY，然后测试模型列表：

```bash theme={null}
curl --fail-with-body https://api.apione.ai/v1/models \
  -H "Authorization: Bearer $APIONE_API_KEY"
```

返回模型列表说明该进程的基本网络和认证可用。接着选择支持相应协议的模型测试推理请求。避免开启输出完整认证头的调试日志。

## 需要代理时

将示例端口替换为自己已运行的代理端口：

```bash theme={null}
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1,::1"
```

不同客户端和 HTTP 库对代理变量的支持不同。CLI 从新终端启动；桌面程序使用其网络设置或受支持的启动方式；Node.js 应结合当前版本和客户端文档检查代理行为。

## 容器与远程部署

* Docker 内的 127.0.0.1 指向容器自身，不能直接代表宿主机代理。
* 云服务器上的 OpenClaw、Dify、Open WebUI 应从服务器侧排查网络。
* SSH 终端中的环境变量不会自动传给 systemd 或后台服务，需要在服务环境中单独配置并重启。
* 企业证书环境应安装可信 CA；不要用关闭 TLS 验证作为常规解决方案。

## 按错误定位

DNS 失败检查解析；连接超时检查出口和防火墙；TLS 错误检查证书链及系统时间；401 检查密钥；403 检查权限；404 检查协议与路径；429 检查额度及并发。

提交排障信息时附上客户端版本、时间、脱敏错误和 X-Maxx-Request-ID，隐藏 API Key 与认证头。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.