热门搜索:
whalebone/agent
whalebone
Whalebone Agent是连接Whalebone服务的客户端代理，用于配置和管理DNS解析、网络安全相关功能，支持证书认证、日志管理等特性。
下载次数: 0状态：社区镜像维护者：whalebone仓库类型：镜像最近更新：5 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Whalebone Agent镜像说明
镜像概述
Whalebone Agent是Whalebone平台的客户端组件，用于与Whalebone服务建立安全连接，实现DNS解析、网络安全防护等功能的配置与管理。该镜像支持证书认证、参数自定义、日志持久化等特性，适用于企业和个人部署Whalebone DNS安全解决方案。
核心功能
- 通过WSS协议与Whalebone代理服务建立加密连接；
- 支持客户端证书和私钥的Base64编码配置；
- 可自定义本地解析器地址、日志级别、API端口等参数；
- 管理DNS解析器配置文件和日志输出；
- 提供CLI接口和集成测试支持；
- 通过卷挂载实现配置、日志和数据的持久化。
使用场景
- 企业部署Whalebone DNS安全解决方案，实现网络流量过滤、***防护；
- 个人或组织用于管理域名解析，增强网络安全；
- 集成到现有Docker环境中，实现自动化的DNS安全管理。
配置说明
环境变量
| 变量名 | 描述 | 可选 | 默认值 |
|---|---|---|---|
| CLIENT_CRT_BASE64 | 客户端证书的Base64编码字符串 | 否 | - |
| CLIENT_KEY_BASE64 | 客户端私钥的Base64编码字符串 | 否 | - |
| PROXY_ADDRESS | 代理服务地址（格式：wss:// | 否 | - |
| LOGGING_LEVEL | 日志级别（设置后启用调试模式，接受任意值） | 是 | - |
| LOCAL_RESOLVER_ADDRESS | 本地解析器地址 | 是 | localhost |
| PERIODIC_INTERVAL | 周期性发送系统信息的时间间隔（秒） | 是 | 60 |
| KRESMAN_LISTENER | Kresman缓存监听器地址 | 是 | http:localhost:8080 |
| LOCAL_API_PORT | 本地API端口 | 是 | 8765 |
| KEEP_ALIVE | Keepalive ping间隔时间 | 是 | 10s |
卷挂载
| 本地路径 | 容器路径 | 用途 |
|---|---|---|
| /var/run/docker.sock | /var/run/docker.sock | 访问Docker API |
| /etc/***/ | /etc/whalebone/resolver/ | 保存解析器配置文件 |
| /var/log/whalebone/agent/ | /etc/whalebone/logs/ | 暴露Agent日志 |
| /var/sinkhole/ | /etc/***man | Kresman的sinkhole文件 |
| /etc/whalebone/cli/ | /etc/whalebone/cli/ | CLI代理接口 |
| /etc/whalebone/agent/ | /etc/whalebone/compose/ | 暴露Docker Compose配置和升级文件 |
部署示例
Docker Run命令
bashdocker run -d \ --name whalebone-agent \ -e CLIENT_CRT_BASE64="YOUR_BASE64_ENCODED_CLIENT_CERT" \ -e CLIENT_KEY_BASE64="YOUR_BASE64_ENCODED_CLIENT_KEY" \ -e PROXY_ADDRESS="wss://your-proxy-server:8443/wsproxy/ws" \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /etc/whalebone/kres:/etc/whalebone/resolver \ -v /var/log/whalebone/agent:/etc/whalebone/logs \ -v /var/sinkhole:/etc/whalebone/kresman \ -v /etc/whalebone/cli:/etc/whalebone/cli \ -v /etc/whalebone/agent:/etc/whalebone/compose \ whalebone/agent:1.x.x
集成测试
通过tests/integration/目录下的docker-compose文件启动测试，测试结果将显示在_current_directory__tester_1容器的日志中。
===END===
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull whalebone/agent:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"