{"id":23231342,"url":"https://github.com/cnily03/ssl-autoupdater","last_synced_at":"2025-04-05T19:26:13.740Z","repository":{"id":221057487,"uuid":"751541975","full_name":"Cnily03/ssl-autoupdater","owner":"Cnily03","description":"Automatically upload and update your SSL certificates to cloud service.","archived":false,"fork":false,"pushed_at":"2024-06-07T16:28:38.000Z","size":154,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-11T17:17:03.622Z","etag":null,"topics":["acme-sh","cloud-services","letsencrypt","ssl-certificate","update-script","update-service"],"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/Cnily03.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-02-01T20:13:56.000Z","updated_at":"2024-06-26T14:06:05.000Z","dependencies_parsed_at":"2024-06-07T15:47:30.140Z","dependency_job_id":"85a2ab59-cbf6-442a-9c6d-9d4a532b7dda","html_url":"https://github.com/Cnily03/ssl-autoupdater","commit_stats":null,"previous_names":["cnily03/ssl-autoupdater"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cnily03%2Fssl-autoupdater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cnily03%2Fssl-autoupdater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cnily03%2Fssl-autoupdater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cnily03%2Fssl-autoupdater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cnily03","download_url":"https://codeload.github.com/Cnily03/ssl-autoupdater/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247388574,"owners_count":20931062,"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":["acme-sh","cloud-services","letsencrypt","ssl-certificate","update-script","update-service"],"created_at":"2024-12-19T02:14:22.104Z","updated_at":"2025-04-05T19:26:13.721Z","avatar_url":"https://github.com/Cnily03.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SSL AutoUpdater\n\nThis project is aimed to update SSL certificates (manually uploaded, such as Let's Encrypt) automatically on different server providers (QCloud, Aliyun, Qiniu, etc.).\n\n- **Supported Providers**\n\n  - [x] 腾讯云 (QCloud)\n  - [x] 七牛云 (Qiniu)\n\n## Usage\n\nMake sure there are certificates on your machine, and this project will upload and update them automatically.\n\nThe default certificate founder is `acme.sh`, you can modify the option `founder` as a function to customize. For further instructions, please refer to the type definition.\n\n### Node.js\n\nInstall the package\n\n```shell\nnpm i -S ssl-autoupdater\n```\n\nExample:\n\n```javascript\nconst autossl = require(\"ssl-autoupdater\")\n\nconst QCloudUpdater = new autossl.updater.QCloud(\"your secretId\", \"your secretKey\")\nQCloudUpdater.watch() // watch and update automatically\n```\n\nAdvanced usage for sending mail:\n\n```javascript\nconst mailer = new autossl.MailSender({\n  host: \"smtp.example.com\",\n  port: 465,\n  secure: true,\n  auth: { // authentification for the smtp server\n    username: \"your auth username\",\n    password: \"your auth password\"\n  },\n  sender: { // set the sender\n    name: \"your name to send\",\n    email: \"your email to send\"\n  },\n  receiver: [\"who@example.com\"] // a list of receivers\n})\n\nconst QCloudUpdater = new autossl.updater.QCloud(\"your secretId\", \"your secretKey\", {\n  mailer: mailer // when the option `mailer` is set, the updater will send mail once after triggering the event\n})\n```\n\nMore examples can be found in directory `test/`.\n\n### Docker\n\nPull `cnily03/ssl-autoupdater` from Docker Hub\n\n```shell\ndocker run -itd \\\n  -v /path/to/your/config.js:/app/data/config.js \\\n  -v ~/.acme.sh:/root/.acme.sh \\\n  --restart=unless-stopped \\\n  --name ssl-autoupdater \\\n  cnily03/ssl-autoupdater\n```\n\n\u003e [!TIP]\n\u003e Docker compose file is also provided in the repository.\n\u003e Edit it according to annotations in the file.\n\u003e Then run `docker compose up -d` to start the service.\n\nReplace `/path/to/your/config.js` with your own configuration file.\n\nOr you can mount the whole directory to `/app/data/` to make it easier to manage.\n\nConfiguration file is similar to the file `config.js` at the root of this repository.\n\n## References\n\n- [tencentcloud-sdk-nodejs](https://github.com/TencentCloud/tencentcloud-sdk-nodejs)\n- [developer.qiniu.com](https://developer.qiniu.com)\n\n## License\n\nCopyRight (c) Cnily03. All rights reserved.\n\nLicensed under the [MIT](https://github.com/Cnily03/ssl-autoupdater?tab=MIT-1-ov-file) License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnily03%2Fssl-autoupdater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcnily03%2Fssl-autoupdater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnily03%2Fssl-autoupdater/lists"}