{"id":16240056,"url":"https://github.com/boris1993/qinglong-bot","last_synced_at":"2025-10-18T19:41:19.132Z","repository":{"id":244570703,"uuid":"815603725","full_name":"boris1993/qinglong-bot","owner":"boris1993","description":"通过机器人webhook更新青龙中的环境变量","archived":false,"fork":false,"pushed_at":"2024-09-08T16:20:13.000Z","size":132,"stargazers_count":29,"open_issues_count":2,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-11T13:45:52.939Z","etag":null,"topics":["bot","qinglong","typescript","webhook"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boris1993.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,"publiccode":null,"codemeta":null}},"created_at":"2024-06-15T15:46:10.000Z","updated_at":"2024-09-15T17:38:48.000Z","dependencies_parsed_at":"2024-06-28T17:14:55.949Z","dependency_job_id":"9d75cf7c-d9d3-4ff9-a729-3b0155968ff6","html_url":"https://github.com/boris1993/qinglong-bot","commit_stats":null,"previous_names":["boris1993/qinglong-env-updater","boris1993/qinglong-bot"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fqinglong-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fqinglong-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fqinglong-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fqinglong-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boris1993","download_url":"https://codeload.github.com/boris1993/qinglong-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243814866,"owners_count":20352051,"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":["bot","qinglong","typescript","webhook"],"created_at":"2024-10-10T13:46:03.730Z","updated_at":"2025-10-18T19:41:19.048Z","avatar_url":"https://github.com/boris1993.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"通过机器人更新青龙中的环境变量\n---\n![GitHub License](https://img.shields.io/github/license/boris1993/qinglong-bot)\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/boris1993/qinglong-bot/build.yml)\n![Docker Pulls](https://img.shields.io/docker/pulls/boris1993/qinglong-bot)\n![Docker Image Version](https://img.shields.io/docker/v/boris1993/qinglong-bot?sort=semver)\n![Docker Image Size](https://img.shields.io/docker/image-size/boris1993/qinglong-bot)\n\n迫于美团脚本的cookie经常过期，而想起更新的时候我通常访问不到自己服务器上的青龙面版，于是开发了这个工具来通过机器人来更新。\n\n## 目前支持的机器人\n\n- 钉钉群聊自定义机器人\n- Telegram机器人\n\n## 配置和部署\n\n### 获得青龙的Client ID和Client Secret\n\n- 前往青龙面板的`系统设置`-\u003e`应用设置`页面，创建一个新应用并赋予`环境变量`和`定时任务`权限\n- 创建成功后，分别点击Client ID列和Client Secret列的复制图标，得到青龙的Client ID和Client Secret\n\n### 创建和添加机器人\n\n#### 钉钉\n\n- 进入[钉钉管理后台](https://oa.dingtalk.com/)并创建一个组织，因为默认的`淘系技术部开放平台虚拟企业`我们没有管理员权限，不能创建应用\n- 使用刚创建的组织登陆[钉钉开放平台](https://open.dingtalk.com/)\n- 进入开发者后台的`应用开发`页面，点击`创建应用`，填写`应用名称`和`应用描述`，点击`保存`\n- 在`添加应用能力`页面添加`机器人`，打开`机器人配置`的开关并填写需要的内容，`机器人消息预览图`\n  随便传个图片就行，`消息接收模式`选`Stream模式`，然后点击`发布`\n- 进入`版本管理与发布`页面，点击`创建新版本`，`版本描述`随便写点什么就行，点击`保存`然后点击`直接发布`\n- 进入`凭证与基础信息`页面，在`应用凭证`面版中分别点击`Client ID`和`Client Secret`的复制按钮即可得到机器人的Client\n  ID和Client Secret\n- 进入钉钉客户端，选择组织默认的全员群或创建一个群，点击右上角的`群设置`，点击`机器人`，然后点击`添加机器人`\n  ，在搜索框中搜索刚刚创建的应用的名字，然后跟随指引添加\n\n#### Telegram\n\n- 使用`BotFather`机器人创建一个Bot，按要求回复各个问题，最后记下bot token备用\n- 关注这个刚刚创建的Bot，发送`/start`命令开始使用\n\n### 部署\n\n如果你访问Docker\nHub有困难，那么也可以换成托管在阿里云的镜像`registry.cn-hangzhou.aliyuncs.com/boris1993/qinglong-bot`。\n\n#### 配置参数\n\n- 必填（如填写不完整则本应用会拒绝启动）\n  - QINGLONG_URL：青龙的URL，如`http://127.0.0.1:5700`\n  - QINGLONG_CLIENT_ID：青龙的Client ID\n  - QINGLONG_CLIENT_SECRET：青龙的Client Secret\n- 钉钉机器人（如填写不完整，则不会启用钉钉机器人）\n  - DINGTALK_CLIENT_ID：钉钉机器人的Client ID\n  - DINGTALK_CLIENT_SECRET：钉钉机器人的Client Secret\n- Telegram机器人\n  - TG_BOT_TOKEN：Telegram机器人的bot token（如不填写则不会启用Telegram机器人）\n  - TG_PROXY：用于访问Telegram的HTTP代理地址，如果你能直接连接Telegram那么这个可以不填\n  - TG_API_ROOT：自定义Telegram API的域名，默认为`https://api.telegram.org`\n\n#### Docker\n\n```shell\ndocker run -d --restart always \\\n  -e QINGLONG_URL=\u003c青龙的URL，如http://127.0.0.1:5700\u003e \\\n  -e QINGLONG_CLIENT_ID=\u003c青龙的Client ID\u003e \\\n  -e QINGLONG_CLIENT_SECRET=\u003c青龙的Client Secret\u003e \\\n  -e DINGTALK_CLIENT_ID=\u003c钉钉机器人的Client ID\u003e \\\n  -e DINGTALK_CLIENT_SECRET=\u003c钉钉机器人的Client Secret\u003e \\\n  -e TG_BOT_TOKEN=\u003cTelegram机器人的bot token\u003e \\\n  -e TG_PROXY=\u003c用于访问Telegram的HTTP代理地址\u003e \\\n  -e TG_API_ROOT=\u003c自定义Telegram API域名\u003e \\\n  -p 3000:3000 \\\n  --name qinglong-bot \\\n  boris1993/qinglong-bot:latest\n```\n\n#### Docker Compose\n\n```yaml\n---\nversion: '3'\n\nservices:\n  qinglong-bot:\n    image: boris1993/qinglong-bot:latest\n    container_name: qinglong-bot\n    restart: always\n    environment:\n      TZ: Asia/Shanghai\n      QINGLONG_URL: \u003c青龙的URL，如http://127.0.0.1:5700\u003e\n      QINGLONG_CLIENT_ID: \u003c青龙的Client ID\u003e\n      QINGLONG_CLIENT_SECRET: \u003c青龙的Client Secret\u003e\n      DINGTALK_CLIENT_ID: \u003c钉钉机器人的Client ID\u003e\n      DINGTALK_CLIENT_SECRET: \u003c钉钉机器人的Client Secret\u003e\n      TG_BOT_TOKEN: \u003cTelegram机器人的bot token\u003e\n      TG_PROXY: \u003c用于访问Telegram的HTTP代理地址\u003e\n      TG_API_ROOT: \u003c自定义Telegram API域名\u003e\n    ports:\n      - '3000:3000'\n```\n\n## 使用\n\n### 支持的命令\n\n| 命令       | 简单命令 | 格式                                 |\n|----------|----------|------------------------------------|\n| 获取所有环境变量 | env list | 获取所有环境变量                           |\n| 添加环境变量   | env add  | 添加环境变量#环境变量名称=环境变量值（多个环境变量用英文逗号分割） |\n| 更新环境变量   | env put  | 更新环境变量#环境变量名称=环境变量值                |\n| 删除环境变量   | env del  | 删除环境变量#环境变量ID（多个环境变量ID用英文逗号分割）|\n| 获取所有任务   | cron list | 获取所有任务                             |\n| 运行任务     | cron run  | 运行任务#定时任务名称                        |\n| 获取任务日志   | cron log  | 获取任务日志#定时任务名称                      |\n\n### 用法\n\n| 客户端      | 说明                          |\n|----------|-----------------------------|\n| 钉钉       | 在添加好机器人后，通过在群里at这个机器人的方式来操作 |\n| Telegram | 直接向机器人发送命令即可                |\n\n## 许可协议\n\n该软件依照[MIT](LICENSE)协议开放源代码。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboris1993%2Fqinglong-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboris1993%2Fqinglong-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboris1993%2Fqinglong-bot/lists"}