{"id":13842491,"url":"https://github.com/Z4HD/coolq-telegram-bot-docker","last_synced_at":"2025-07-11T15:31:40.783Z","repository":{"id":164689477,"uuid":"110135345","full_name":"Z4HD/coolq-telegram-bot-docker","owner":"Z4HD","description":"使用Docker容器化的QQ和Telegram的消息互转机器人。Source: jqqqqqqqqqq/coolq-telegram-bot","archived":true,"fork":false,"pushed_at":"2018-04-10T14:43:07.000Z","size":43,"stargazers_count":19,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-04T21:45:33.373Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Z4HD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2017-11-09T15:53:56.000Z","updated_at":"2024-12-26T07:00:12.000Z","dependencies_parsed_at":"2024-01-31T04:02:21.752Z","dependency_job_id":null,"html_url":"https://github.com/Z4HD/coolq-telegram-bot-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Z4HD/coolq-telegram-bot-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z4HD%2Fcoolq-telegram-bot-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z4HD%2Fcoolq-telegram-bot-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z4HD%2Fcoolq-telegram-bot-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z4HD%2Fcoolq-telegram-bot-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Z4HD","download_url":"https://codeload.github.com/Z4HD/coolq-telegram-bot-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z4HD%2Fcoolq-telegram-bot-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264840787,"owners_count":23671743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T17:01:37.330Z","updated_at":"2025-07-11T15:31:40.389Z","avatar_url":"https://github.com/Z4HD.png","language":null,"funding_links":[],"categories":["Others","Others (1002)"],"sub_categories":[],"readme":"# coolq-telegram-bot-docker v3.x\n\n## 本镜像已不再维护\n\n使用Docker容器化的QQ和Telegram的消息互转机器人，本分支专为v3.x版本的coolq-telegram-bot设计。\n\nSource: jqqqqqqqqqq/coolq-telegram-bot\n\n镜像基于[richardchien/cqhttp](https://richardchien.github.io/coolq-http-api/3.3/#/Docker)构建\n\n每次构建都会从[jqqqqqqqqqq/coolq-telegram-bot](https://github.com/jqqqqqqqqqq/coolq-telegram-bot)拉取最新的代码。\n\n# 构建\n\u003e*表示死活登不上Docker.com的账号，因此暂时不发布至Docker Hub*，请手动构建，3Q2X。\n\n进行下列操作前请先\n```shell\ngit clone https://github.com/Z4HD/coolq-telegram-bot-docker\n```\n\n## 构建稳定版bot镜像（master分支）\n```shell\nsudo docker build -t \"coolq-telegram-bot\" .\n```\n\n## 构建测试版bot镜像（dev分支）\n```shell\nsudo docker build -t \"coolq-telegram-bot-dev\" -f Dockerfile-dev .\n```\n\n# 运行\n使用与[coolq/wine-coolq](https://cqp.cc/t/34558)和[richardchien/cqhttp](https://richardchien.github.io/coolq-http-api/3.3/#/Docker)相同的指令启动。将下面示例中的中括号内的内容（包括中括号）按实际情况修改。\n\n```shell\nsudo docker run --name=ctb -d -p 【VNC页面端口号】:9000 -v 【酷Q数据目录】:/home/user/coolq -e VNC_PASSWD=【VNC页面密码】 -e COOLQ_ACCOUNT=【酷Q机器人的QQ账号】 coolq-telegram-bot\n```\n\n随后便可通过 `sudo docker stop ctb`等指令控制后台服务的运行。\n\n参考coolq-http的的配置教程配置完coolq并启用CoolqHttpAPI插件后，输入下列指令开始bot的后台运行\n\n```shell\n#       docker exec -it ctb su\n\u003c容器内\u003e python3 daemon.py start\n\u003c容器内\u003e exit\n```\n\n使用`sudo docker exec -it ctb su`以root身份深入到容器内部\n\n### 注意事项\n1. 环境变量`CTB_JSON_SETTINGS_PATH`用于指定JSON格式转发Bot配置文件的路径（容器内），默认值`/home/user/coolq/bot_constant.json`。请将JSON格式配置文件重命名为`bot_constant.json`后放置于coolq数据目录下即可。\n2. 您需要自行安装并启用[CQ http API](https://github.com/richardchien/coolq-http-api/)。[如何安装？](https://richardchien.github.io/coolq-http-api/)\n\n# 更新\n\n## 使用Json格式配置文件（默认）\n使用tools/bot-upgrade.py升级，可在升级后保留对Json格式配置文件的支持。\n\n```shell\nsudo docker exec -it ctb sh -c \"python3 tools/bot-upgrade.py\"\n```\n\n## 使用Py格式配置文件\n直接通过`git pull`升级至最新版本。\n\n```shell\nsudo docker exec -it ctb sh -c \"git pull\"\n```\n\n# Docker.com 一般的准则和建议\n- [ ] 容器应该是短暂的\n- [ ] 使用.dockerignore文件\n- [ ] 避免安装不必要的包\n- [ ] 每个容器只运行一个进程\n- [ ] 最小化层的数量\n- [x] 排序多行参数\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZ4HD%2Fcoolq-telegram-bot-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZ4HD%2Fcoolq-telegram-bot-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZ4HD%2Fcoolq-telegram-bot-docker/lists"}