ed CLI

Appearance

常见问题 ​

本页面收集了用户在使用 ed CLI 过程中遇到的常见问题和解决方案。

安装相关 ​

Q: 安装脚本执行失败怎么办？ ​

A: 请尝试以下解决方案：

  1. 检查网络连接：确保能够访问 https://ediptest.edtunnel.best
  2. 使用手动安装：直接下载对应平台的二进制文件
  3. 权限问题：确保有安装目录的写入权限
bash
# Linux/macOS 权限修复
chmod +x ed-iptest-*
sudo mv ed-iptest-* /usr/local/bin/ed

Q: 如何验证安装是否成功？ ​

A: 运行版本命令：

bash
ed version

如果显示版本信息，说明安装成功。

Q: 如何卸载 ed CLI？ ​

A: 删除相关文件：

bash
# 删除二进制文件
rm /usr/local/bin/ed  # Linux/macOS
# 或从 PATH 中删除 ed.exe  # Windows

# 删除配置文件（可选）
rm -rf ~/.edtunnel

认证相关 ​

Q: 登录失败，提示认证错误？ ​

A: 请检查：

  1. 邮箱格式：确保邮箱地址格式正确
  2. 密码正确性：确认密码输入正确
  3. 网络连接：确保能够访问认证服务器
  4. 重新登录：尝试重新登录
bash
ed login

Q: 令牌过期怎么办？ ​

A: 使用刷新命令：

bash
ed refresh

Q: 忘记密码怎么办？ ​

A: 请联系 EDtunnel 客服重置密码。

IP 测试相关 ​

Q: iptest 命令没有返回结果？ ​

A: 可能的原因和解决方案：

  1. 网络问题：检查网络连接
  2. API 限制：检查是否达到使用限制
  3. 参数错误：检查命令参数是否正确
bash
# 尝试简单测试
ed iptest -c HKG -L 5

Q: 如何理解测试结果？ ​

A: 测试结果包含以下关键指标：

  • TCP延迟：越低越好，通常 < 100ms 为佳
  • 下载速度：越高越好，单位 MB/s
  • 数据中心：节点所在地理位置
  • 网络运营商：节点的网络提供商

Q: 为什么测速结果不准确？ ​

A: 影响因素：

  1. 本地网络：您的网络环境会影响结果
  2. 时间段：不同时间段网络状况不同
  3. 测试样本：建议多次测试取平均值
  4. 线程数：可以调整测速线程数
bash
# 调整测速线程数
ed iptest -c HKG -L 10 -s 3

Q: 如何测试自己的 IP 列表？ ​

A: 使用文件导入功能：

bash
# 创建 IP 列表文件
echo "8.8.8.8" > my_ips.txt
echo "1.1.1.1" >> my_ips.txt

# 测试
ed iptest -f my_ips.txt

订阅检查相关 ​

Q: sub-check 运行时间太长？ ​

A: 优化建议：

  1. 减少并发数：降低 concurrent 参数
  2. 增加超时时间：适当增加 timeout
  3. 启用过滤：使用关键词过滤减少测试节点
yaml
sub_check:
  concurrent: 50  # 降低并发
  timeout: 10     # 增加超时
  filters:
    exclude_keywords: ["过期", "测试"]

Q: 订阅链接解析失败？ ​

A: 检查点：

  1. 链接有效性：确保订阅链接可以访问
  2. 格式支持：确认链接格式被支持
  3. 网络访问：检查网络是否能访问订阅源

Q: 流媒体检测不准确？ ​

A: 原因和解决方案：

  1. 检测时效性：流媒体策略可能变化
  2. 网络环境：您的网络环境可能影响检测
  3. 节点质量：节点本身可能有问题

配置文件相关 ​

Q: 配置文件在哪里？ ​

A: 配置文件位置：

  1. ./config/config.yaml - 当前目录
  2. ~/.edtunnel/config.yaml - 用户主目录
  3. 通过 --config 参数指定

Q: 配置文件格式错误？ ​

A: 常见问题：

  1. 缩进问题：YAML 对缩进敏感，使用空格而非制表符
  2. 字符编码：确保使用 UTF-8 编码
  3. 语法验证：使用在线 YAML 验证器检查

Q: 如何重置配置？ ​

A: 重置配置：

bash
# 备份现有配置
cp ~/.edtunnel/config.yaml ~/.edtunnel/config.yaml.bak

# 重置配置
ed config reset

性能优化 ​

Q: 如何提高测试速度？ ​

A: 优化建议：

  1. 调整并发数：根据网络环境调整
  2. 减少测试项目：禁用不需要的检测
  3. 使用本地缓存：启用结果缓存
bash
# 快速测试模式
ed iptest -c HKG -L 10 -s 0  # 禁用测速

Q: 内存占用过高？ ​

A: 解决方案：

  1. 减少并发数：降低同时处理的任务数
  2. 分批处理：对大量数据分批处理
  3. 清理缓存：定期清理临时文件

网络问题 ​

Q: 连接超时怎么办？ ​

A: 解决步骤：

  1. 检查网络：确保网络连接正常
  2. 增加超时时间：在配置中增加超时设置
  3. 更换 DNS：尝试使用不同的 DNS 服务器
  4. 使用代理：如果有网络限制，考虑使用代理

Q: 部分地区无法访问？ ​

A: 可能的解决方案：

  1. 网络限制：您的网络可能有访问限制
  2. 更换测试地区：尝试其他地区的节点
  3. 联系客服：如果问题持续，请联系技术支持

错误代码 ​

常见错误代码说明 ​

错误代码含义解决方案
401认证失败检查登录信息，重新登录
403权限不足检查账户权限，联系客服
404资源不存在检查参数，确认资源存在
429请求过于频繁减少请求频率，等待后重试
500服务器错误稍后重试，如持续请联系客服

MCP 服务器相关 ​

Q: MCP 服务器无法启动？ ​

A: 检查点：

  1. 端口占用：确保指定端口未被占用
  2. 配置文件：检查 MCP 配置文件是否正确
  3. 权限问题：确保有足够的系统权限
bash
# 检查端口占用
lsof -i :8080

# 启动 MCP 服务器
ed iptest-mcp --port 8081

Q: AI 工具无法连接到 MCP 服务器？ ​

A: 解决方案：

  1. 检查连接配置：确保 AI 工具的连接配置正确
  2. 网络访问：确保网络可以访问 MCP 服务器
  3. 协议版本：确认 MCP 协议版本兼容

其他问题 ​

Q: 如何获得技术支持？ ​

A: 支持渠道：

  1. 文档查询：首先查看官方文档
  2. GitHub Issues：在 GitHub 仓库提交问题
  3. 社区论坛：在社区寻求帮助
  4. 邮件支持：发送邮件至技术支持

Q: 如何报告 Bug？ ​

A: 报告 Bug 时请包含：

  1. 版本信息：ed version 输出
  2. 操作系统：系统版本信息
  3. 错误信息：完整的错误日志
  4. 复现步骤：详细的操作步骤
  5. 配置信息：相关配置文件（隐藏敏感信息）

Q: 如何参与开发？ ​

A: 参与方式：

  1. Fork 仓库：在 GitHub 上 fork 项目
  2. 提交 PR：提交改进和修复
  3. 文档贡献：改善文档质量
  4. 测试反馈：参与测试并提供反馈

还有其他问题？

如果您的问题没有在这里找到答案，请：

  1. 搜索 GitHub Issues
  2. 提交新的 Issue
  3. 联系技术支持

Released under the MIT License.

Copyright © 2024 ed CLI