DS2API默认端口5001改端口指南DS2API_HOST_PORT全场景配置详解【免费下载链接】ds2apiDeepSeek-Compatible Middleware Interface: A technical exploration project in Go, focusing on high-concurrency protocol adaptation. It serves as a reference implementation for converting diverse web protocols into standardized formats.项目地址: https://gitcode.com/GitHub_Trending/ds/ds2apiDS2API 是一个用 Go 编写的 DeepSeek 兼容 API 中间件协议适配网关默认在5001 端口提供服务把 DeepSeek 协议转换为 OpenAI / Claude / Gemini 等标准接口。当你遇到5001 端口被占用或想把宿主机端口映射成别的值时只需要理解两个变量容器内部的PORT和 Docker 映射的DS2API_HOST_PORT。本文将覆盖 Docker、本地二进制、systemd、Nginx 反向代理和云平台等全场景的改端口方法5 分钟即可完成配置。一、先搞清楚5001 端口从哪里来DS2API 服务在进程内固定监听5001实际绑定地址为0.0.0.0:5001因此局域网内设备也能通过你的内网 IP 直接访问。部署方式进程内监听端口对外暴露端口改端口变量Docker Compose5001固定默认 6011DS2API_HOST_PORT本地二进制 / 源码运行5001可改同监听端口PORTsystemd 服务由EnvironmentPORT决定同监听端口PORTNginx 反向代理后端任意Nginx 端口80/443代理层配置Zeabur / Vercel 云部署平台托管平台域名PORTZeabur 固定 5001一句话记忆容器场景改DS2API_HOST_PORT裸机进程改PORT云托管平台用域名不碰端口。二、Docker 部署DS2API_HOST_PORT 改宿主机端口最常用仓库自带的 docker-compose.yml 中端口映射写得很直白ports: - ${DS2API_HOST_PORT:-6011}:5001含义是容器内永远固定5001宿主机端口由环境变量DS2API_HOST_PORT决定不设置时默认6011。一键安装步骤git clone https://gitcode.com/GitHub_Trending/ds/ds2api cd ds2api cp .env.example .env编辑.env按需设置宿主机端口# 不改端口默认 http://localhost:6011 # 想用 5001 直连 DS2API_HOST_PORT5001 # 想避开常用端口段如 8000 DS2API_HOST_PORT8100然后启动并验证docker-compose up -d curl http://localhost:8100/healthz # 换成你设置的端口 开发环境使用的 docker-compose.dev.yml 采用完全相同的写法DS2API_HOST_PORT一样生效开发联调时记得两边端口保持一致。详细说明参见 docs/DEPLOY.md 的 Docker 部署章节。三、本地运行 / 二进制部署用 PORT 直接改监听端口不走 Docker 时5001是进程内的默认值用环境变量PORT覆盖即可。最快配置方法# 编译并换端口启动 go build -o ds2api ./cmd/ds2api PORT8080 ./ds2api # 现在访问 http://127.0.0.1:8080使用仓库自带的启动脚本 start.mjs 时PORT同样生效例如DS2API_ADMIN_KEYmykey PORT8080 node start.mjs dev⚠️ 注意PORT改端口后所有访问地址API 文档示例、管理台/admin都要换成对应端口否则会出现日志正常但面板打不开的假象。systemd 服务化场景在 docs/DEPLOY.md 给出的 service 文件中通过EnvironmentPORT5001一行指定端口改成任意值即可[Service] EnvironmentPORT9000四、Nginx 反向代理不改 5001改由代理层换端口很多生产环境更推荐后端保持 5001Nginx 对外 443的方案。此时不需要改 DS2API 任何配置只需保证代理关闭缓冲SSE 流式响应才能正常工作location / { proxy_pass http://127.0.0.1:5001; proxy_http_version 1.1; proxy_set_header Connection ; proxy_buffering off; chunked_transfer_encoding on; }需要 HTTPS 时把证书配置加到server层即可完整配置见 docs/DEPLOY.md 的反向代理Nginx章节。五、云部署Zeabur / Vercel 端口怎么算Zeaburzeabur.yaml 模板固定PORT5001并暴露 HTTP 端口5001最终用户访问的是平台分配的域名无需手动指定端口健康检查路径填/healthz。VercelServerless 模式由平台接管监听端口你只需要关注DS2API_ADMIN_KEY等环境变量端口概念不适用。六、改完端口的验证清单无论哪种方式改完后依次执行curl -s http://localhost:你的端口/healthz # 预期 {status:ok} curl -s http://localhost:你的端口/readyz # 预期 {status:ready} curl -s http://localhost:你的端口/v1/models # 预期返回模型列表管理台访问http://localhost:你的端口/admin应返回 200。若 Docker 场景下检查失败优先确认.env里的DS2API_HOST_PORT是否真的被docker-compose up -d重新加载修改后需docker-compose up -d重建容器。七、常见问题 FAQQ1DS2API_HOST_PORT5001和PORT5001有什么区别前者只改 Docker 宿主机映射容器内仍监听 5001后者直接改进程监听端口容器内端口也会变。Compose 用户优先用前者改后者可能导致内置健康检查与映射同时失配。Q2提示bind: address already in use怎么办说明 5001或你指定的端口被其他程序占用。Docker 用户设置一个空闲的DS2API_HOST_PORT如 6100裸机用户设置PORT或先释放占用进程。Q3改了端口后客户端要改什么只需把 Base URL 从http://localhost:5001换成新端口例如http://localhost:8100接口路径/v1/chat/completions、/anthropic/v1/messages等均不变更多示例见 API.md。Q4局域网手机/其他设备能访问吗可以。服务绑定0.0.0.0同一局域网内用http://你的内网IP:端口即可注意放行对应端口的防火墙。 小结记住容器内 5001 固定不动DS2API_HOST_PORT管宿主机映射PORT管进程监听反向代理管对外域名这一条主线DS2API 的端口配置就不会出错。完整部署细节可继续查阅 docs/DEPLOY.md 与 docs/DEPLOY.en.md。【免费下载链接】ds2apiDeepSeek-Compatible Middleware Interface: A technical exploration project in Go, focusing on high-concurrency protocol adaptation. It serves as a reference implementation for converting diverse web protocols into standardized formats.项目地址: https://gitcode.com/GitHub_Trending/ds/ds2api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 DS2API默认端口5001改端口指南：DS2API_HOST_PORT全场景配置详解
DS2API默认端口5001改端口指南DS2API_HOST_PORT全场景配置详解【免费下载链接】ds2apiDeepSeek-Compatible Middleware Interface: A technical exploration project in Go, focusing on high-concurrency protocol adaptation. It serves as a reference implementation for converting diverse web protocols into standardized formats.项目地址: https://gitcode.com/GitHub_Trending/ds/ds2apiDS2API 是一个用 Go 编写的 DeepSeek 兼容 API 中间件协议适配网关默认在5001 端口提供服务把 DeepSeek 协议转换为 OpenAI / Claude / Gemini 等标准接口。当你遇到5001 端口被占用或想把宿主机端口映射成别的值时只需要理解两个变量容器内部的PORT和 Docker 映射的DS2API_HOST_PORT。本文将覆盖 Docker、本地二进制、systemd、Nginx 反向代理和云平台等全场景的改端口方法5 分钟即可完成配置。一、先搞清楚5001 端口从哪里来DS2API 服务在进程内固定监听5001实际绑定地址为0.0.0.0:5001因此局域网内设备也能通过你的内网 IP 直接访问。部署方式进程内监听端口对外暴露端口改端口变量Docker Compose5001固定默认 6011DS2API_HOST_PORT本地二进制 / 源码运行5001可改同监听端口PORTsystemd 服务由EnvironmentPORT决定同监听端口PORTNginx 反向代理后端任意Nginx 端口80/443代理层配置Zeabur / Vercel 云部署平台托管平台域名PORTZeabur 固定 5001一句话记忆容器场景改DS2API_HOST_PORT裸机进程改PORT云托管平台用域名不碰端口。二、Docker 部署DS2API_HOST_PORT 改宿主机端口最常用仓库自带的 docker-compose.yml 中端口映射写得很直白ports: - ${DS2API_HOST_PORT:-6011}:5001含义是容器内永远固定5001宿主机端口由环境变量DS2API_HOST_PORT决定不设置时默认6011。一键安装步骤git clone https://gitcode.com/GitHub_Trending/ds/ds2api cd ds2api cp .env.example .env编辑.env按需设置宿主机端口# 不改端口默认 http://localhost:6011 # 想用 5001 直连 DS2API_HOST_PORT5001 # 想避开常用端口段如 8000 DS2API_HOST_PORT8100然后启动并验证docker-compose up -d curl http://localhost:8100/healthz # 换成你设置的端口 开发环境使用的 docker-compose.dev.yml 采用完全相同的写法DS2API_HOST_PORT一样生效开发联调时记得两边端口保持一致。详细说明参见 docs/DEPLOY.md 的 Docker 部署章节。三、本地运行 / 二进制部署用 PORT 直接改监听端口不走 Docker 时5001是进程内的默认值用环境变量PORT覆盖即可。最快配置方法# 编译并换端口启动 go build -o ds2api ./cmd/ds2api PORT8080 ./ds2api # 现在访问 http://127.0.0.1:8080使用仓库自带的启动脚本 start.mjs 时PORT同样生效例如DS2API_ADMIN_KEYmykey PORT8080 node start.mjs dev⚠️ 注意PORT改端口后所有访问地址API 文档示例、管理台/admin都要换成对应端口否则会出现日志正常但面板打不开的假象。systemd 服务化场景在 docs/DEPLOY.md 给出的 service 文件中通过EnvironmentPORT5001一行指定端口改成任意值即可[Service] EnvironmentPORT9000四、Nginx 反向代理不改 5001改由代理层换端口很多生产环境更推荐后端保持 5001Nginx 对外 443的方案。此时不需要改 DS2API 任何配置只需保证代理关闭缓冲SSE 流式响应才能正常工作location / { proxy_pass http://127.0.0.1:5001; proxy_http_version 1.1; proxy_set_header Connection ; proxy_buffering off; chunked_transfer_encoding on; }需要 HTTPS 时把证书配置加到server层即可完整配置见 docs/DEPLOY.md 的反向代理Nginx章节。五、云部署Zeabur / Vercel 端口怎么算Zeaburzeabur.yaml 模板固定PORT5001并暴露 HTTP 端口5001最终用户访问的是平台分配的域名无需手动指定端口健康检查路径填/healthz。VercelServerless 模式由平台接管监听端口你只需要关注DS2API_ADMIN_KEY等环境变量端口概念不适用。六、改完端口的验证清单无论哪种方式改完后依次执行curl -s http://localhost:你的端口/healthz # 预期 {status:ok} curl -s http://localhost:你的端口/readyz # 预期 {status:ready} curl -s http://localhost:你的端口/v1/models # 预期返回模型列表管理台访问http://localhost:你的端口/admin应返回 200。若 Docker 场景下检查失败优先确认.env里的DS2API_HOST_PORT是否真的被docker-compose up -d重新加载修改后需docker-compose up -d重建容器。七、常见问题 FAQQ1DS2API_HOST_PORT5001和PORT5001有什么区别前者只改 Docker 宿主机映射容器内仍监听 5001后者直接改进程监听端口容器内端口也会变。Compose 用户优先用前者改后者可能导致内置健康检查与映射同时失配。Q2提示bind: address already in use怎么办说明 5001或你指定的端口被其他程序占用。Docker 用户设置一个空闲的DS2API_HOST_PORT如 6100裸机用户设置PORT或先释放占用进程。Q3改了端口后客户端要改什么只需把 Base URL 从http://localhost:5001换成新端口例如http://localhost:8100接口路径/v1/chat/completions、/anthropic/v1/messages等均不变更多示例见 API.md。Q4局域网手机/其他设备能访问吗可以。服务绑定0.0.0.0同一局域网内用http://你的内网IP:端口即可注意放行对应端口的防火墙。 小结记住容器内 5001 固定不动DS2API_HOST_PORT管宿主机映射PORT管进程监听反向代理管对外域名这一条主线DS2API 的端口配置就不会出错。完整部署细节可继续查阅 docs/DEPLOY.md 与 docs/DEPLOY.en.md。【免费下载链接】ds2apiDeepSeek-Compatible Middleware Interface: A technical exploration project in Go, focusing on high-concurrency protocol adaptation. It serves as a reference implementation for converting diverse web protocols into standardized formats.项目地址: https://gitcode.com/GitHub_Trending/ds/ds2api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考