{"id":22244235,"url":"https://github.com/bl4ckm45k/vpnbot","last_synced_at":"2026-04-05T01:00:16.224Z","repository":{"id":155429881,"uuid":"502367169","full_name":"bl4ckm45k/vpnbot","owner":"bl4ckm45k","description":"Telegram bot on Marzban for Free VPN access with Outline and Xray Core client support ","archived":false,"fork":false,"pushed_at":"2025-06-25T07:39:56.000Z","size":129,"stargazers_count":81,"open_issues_count":4,"forks_count":24,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-12-10T10:39:22.483Z","etag":null,"topics":["marzban","outline","vpnfree"],"latest_commit_sha":null,"homepage":"https://t.me/bl4ckm45k_vpn_bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bl4ckm45k.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2022-06-11T14:14:51.000Z","updated_at":"2025-11-29T22:16:01.000Z","dependencies_parsed_at":"2023-10-17T02:16:39.918Z","dependency_job_id":"b4c0b7be-188f-4b23-a779-e2afdbb88cd2","html_url":"https://github.com/bl4ckm45k/vpnbot","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bl4ckm45k/vpnbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl4ckm45k%2Fvpnbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl4ckm45k%2Fvpnbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl4ckm45k%2Fvpnbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl4ckm45k%2Fvpnbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bl4ckm45k","download_url":"https://codeload.github.com/bl4ckm45k/vpnbot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl4ckm45k%2Fvpnbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31420789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T00:25:07.052Z","status":"ssl_error","status_checked_at":"2026-04-05T00:25:05.923Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["marzban","outline","vpnfree"],"created_at":"2024-12-03T04:35:44.914Z","updated_at":"2026-04-05T01:00:16.144Z","avatar_url":"https://github.com/bl4ckm45k.png","language":"Python","funding_links":[],"categories":["🔥 Awesome [Marzban](https://github.com/Gozargah/Marzban)"],"sub_categories":["Bots"],"readme":"### [Русский язык](README_RU.md)\n### Recommended Hosting Providers\n\n| Provider | Features | Link |\n|---------|----------|------|\n| **Veesp** | Mid-range price, fast, unlimited traffic, clean business IPs | [Visit](https://secure.veesp.com/?affid=1374) |\n| **VDSka** | Cheap, fast, 3 TB traffic | [Visit](https://vdska.ru?p=21892) |\n| **VDSina** | Expensive, fast, reliable — **10% Discount** | [Visit](https://www.vdsina.com/?partner=bv6a5sjwaj) |\n\n### Source code of the Telegram bot [bl4ckm45k_vpn_bot](https://t.me/bl4ckm45k_vpn_bot \"bl4ckm45k_vpn_bot\")\n\n`For security purposes and easy setup, this bot supports only VLESS tcp or grpc protocols with REALITY \nwith automatic generation of private keys and ShortID. \nFor more reliable encryption, always install TLS certificates for the VLESS, VMESS and Trojan protocols\n`\n### Setup\n```bash\nsudo apt update -y \u0026\u0026 sudo apt upgrade -y\nsudo apt install git nano ufw curl cron -y\n```\n\n- Install docker \n```bash\nsudo curl https://get.docker.com | sh\n```\n- Clone this repository\n```bash\ngit clone https://github.com/bl4ckm45k/vpnbot.git\n```\n\n- Navigate to the bot's directory\n```bash\ncd vpnbot\n```\n\nRename the file `env.dist` to `.env`\n```bash\ncat env.dist \u003e .env\n```\n\nReplace `BOT_TOKEN` with your token\n\nIn `ADMIN`, specify the Telegram user ID of the administrator.\n\nYou can find out your user ID through the [Get My ID bot](https://t.me/getmyid_bot \"Get My ID bot\")\n\nDo not change the parameters `USE_WEBHOOK` and `False`, otherwise the bot will not work.\n\nOther parameters are not used in the open-source version.\n\n### Marzban Parameters\nTo set up the login and password, change the variables `SUDO_USERNAME` and `SUDO_PASSWORD` in the .env.marzban file.\n\n### Launch\n```bash\n```bash\nchmod +x update.sh\n./update.sh\n```\n```\n\nDone. The bot will output all host keys from the Marzban panel.\n\n### The Marzban panel will be accessible on port `8002`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbl4ckm45k%2Fvpnbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbl4ckm45k%2Fvpnbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbl4ckm45k%2Fvpnbot/lists"}