DeepLX：免费DeepL API本地部署完全指南

DeepLX是一款将DeepL免费服务转换为本地API的工具，无需Token即可使用，支持第三方程序调用，如沉浸式翻译等应用场景。

---

📥 快速上手：从零开始部署

如何获取项目代码？

执行以下命令克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/de/DeepLX
cd DeepLX

如何安装依赖并启动服务？

安装Go模块依赖：

go mod download

直接运行服务：

go run main.go

⚠️ 注意：首次运行会自动使用默认配置（IP: 0.0.0.0，端口: 1188），服务启动后可通过 http://localhost:1188 访问

---

⚙️ 进阶配置：定制你的API服务

如何修改服务运行参数？

DeepLX支持通过命令行参数或环境变量自定义配置，常用选项对比：

配置项	命令行参数	环境变量	默认值
绑定IP	-ip 127.0.0.1	IP=127.0.0.1	0.0.0.0
服务端口	-port 8080	PORT=8080	1188
访问令牌	-token yourkey	TOKEN=yourkey	无

示例：使用自定义端口和访问令牌启动

go run main.go -port 8080 -token abc123

---

🔍 故障排查：常见问题解决指南

症状：服务启动后无法访问

• 原因：端口被占用或防火墙限制
• 对策：更换未占用端口（如 -port 8081），检查系统防火墙设置

症状：翻译请求返回403错误

• 原因：DL Session配置错误或DeepL服务连接问题
• 对策：通过 -s 参数设置有效DL Session，或检查网络是否能正常访问DeepL官网

症状：编译时报依赖错误

• 原因：Go版本过低或依赖未完全下载
• 对策：升级Go至1.18+版本，执行 go clean modcache 后重新下载依赖

---

💡 实用场景示例

场景1：为翻译软件提供API支持

将DeepLX作为本地API服务，在沉浸式翻译等工具中配置自定义API地址：

API地址：http://localhost:1188/translate
请求方式：POST

支持多语言互译，响应速度比公共API更快。

场景2：批量文档翻译脚本

结合curl命令实现简单的批量翻译功能：

# 英文转中文示例
curl -X POST http://localhost:1188/translate \
  -d '{"text":"Hello World","source_lang":"EN","target_lang":"ZH"}'

---

❓ 常见问题索引

1. 如何设置访问密码保护API？
   使用 -token 参数设置访问令牌，请求时需在Header中携带 Authorization: Bearer 你的令牌

2. 是否支持Docker部署？
   项目提供Dockerfile，可通过 docker build -t deeplx . 构建镜像后运行

3. 如何查看API请求日志？
   当前版本暂不支持日志输出，可通过第三方工具（如Wireshark）监控网络请求

---

提示：更多高级用法可查看项目源码中的 service/config.go 文件，或通过 -h 参数获取完整命令帮助