{"id":14563563,"url":"https://github.com/XOR-op/BoltConn","last_synced_at":"2025-09-04T06:32:13.246Z","repository":{"id":65246495,"uuid":"556202456","full_name":"XOR-op/BoltConn","owner":"XOR-op","description":"Privacy-oriented proxy \u0026 network manager, supporting WireGuard, L7 firewall, App-based policies and scripted MitM.","archived":false,"fork":false,"pushed_at":"2024-11-29T22:18:42.000Z","size":1361,"stargazers_count":55,"open_issues_count":4,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-29T22:33:54.083Z","etag":null,"topics":["firewall","http","https","linux","macos","mitm","proxies","proxy","rust","transparent-proxy","tunnel","wireguard"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/XOR-op.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":"2022-10-23T09:54:39.000Z","updated_at":"2024-11-29T22:18:33.000Z","dependencies_parsed_at":"2023-09-24T05:13:57.735Z","dependency_job_id":"6c31c526-12b8-4f2d-a490-496ea74a5069","html_url":"https://github.com/XOR-op/BoltConn","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XOR-op%2FBoltConn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XOR-op%2FBoltConn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XOR-op%2FBoltConn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XOR-op%2FBoltConn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XOR-op","download_url":"https://codeload.github.com/XOR-op/BoltConn/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231940610,"owners_count":18449183,"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":["firewall","http","https","linux","macos","mitm","proxies","proxy","rust","transparent-proxy","tunnel","wireguard"],"created_at":"2024-09-07T02:03:09.222Z","updated_at":"2025-09-04T06:32:13.232Z","avatar_url":"https://github.com/XOR-op.png","language":"Rust","readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"./assets/icon.svg\" alt=\"BoltConn\" width=\"192\"\u003e\n    \u003cbr/\u003e\n    BoltConn\n    \u003cbr/\u003e\n\u003c/h1\u003e\n\n\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/XOR-op/BoltConn/actions\"\u003e\n\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/XOR-op/BoltConn/check.yml\" alt=\"GitHub Actions\"\u003e\n\u003c/a\u003e\n\u003ca href=\"./LICENSE\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/license-GPLv3-blue.svg\" alt=\"License: GPLv3\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/XOR-op/BoltConn/releases\"\u003e\n\u003cimg src=\"https://img.shields.io/github/v/release/XOR-op/BoltConn?color=00b4f0\" alt=\"Release\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\nA go-to solution for transparent application proxy \u0026 firewall with tunneling and MitM, designed with privacy and security in mind. \nAll efforts made to make you fully control your network. Experimental webui \u0026 desktop client is available in [XOR-op/BoltBoard](https://github.com/XOR-op/BoltBoard).\n\n\n## Features\n- **Fine-grained Traffic Control**: Allow VPN-style global control, or dedicated http/socks5 per-inbound control.\n- **Rule-based Blocking**: Block ad/tracking traffic on a per-process/per-website/flexible way.\n- **Rule-based Tunneling**: Flexible way to tunnel traffic through http/socks5/wireguard/etc outbounds. Able to use compatible rules from similar community.\n- **Audit Traffic**: Audit traffic history by accessing API or dumping into SQLite.\n- **Modify HTTPS Data**: Manipulate requests and responses inside HTTPS traffic to redirect, block or modify them. Support injecting Javascript now.\n\nFor the full features, see [features.md](./docs/features.md).\n\n## Getting Started\n\n### Installation\n#### Pre-built binaries\n- Download pre-built binaries from [release](https://github.com/XOR-op/BoltConn/releases) and add the path of the binary to `$PATH`.\n#### Install latest git version with cargo\n```bash\ncargo install --locked --git https://github.com/XOR-op/BoltConn\n```\n\n### Configuration\nBefore running BoltConn, you should run these two commands first:\n1. Create necessary configuration and runtime files. The default configuration path is `$HOME/.config/boltconn`, and the\ndefault runtime path is `$HOME/.local/share/boltconn`:\n```bash\n# generate configuration files\nboltconn generate init\n```\n2. Generate root certificates with proper permissions for MitM:\n```bash\n# generate root certificates and make them readable only by root user (recommended)\nsudo -E boltconn generate cert\n# or generate them without configuring permissions\nboltconn generate cert --rootless\n```\n\n### Run BoltConn\n```bash\n# run BoltConn globally\nsudo -E boltconn start\n# or run BoltConn with rootless mode (certain features will be unavailable)\nboltconn start --rootless\n```\n\n### CLI Tools for Management\n```bash\nboltconn [conn/proxy/rule/tun/reload/...]\n```\nSee `boltconn --help` for more help.\n\n## Documentations\n\u003e [!NOTE]\n\u003e Documentations are outdated now. Please wait for our update.\n\nLearn more about BoltConn's architecture, RESTful API, and how it compares to other related projects:\n\n- [design.md](./docs/design.md) explains BoltConn's architecture.\n- [restful.md](./docs/restful.md) covers BoltConn's RESTful API.\n- [features.md](./docs/features.md) lists full features of BoltConn.\n\n## Future Plan\n- Stablize Windows support with Wintun driver (it's experimental now).\n\n## License\nThis software is released under the GPL-3.0 license.","funding_links":[],"categories":["rust"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXOR-op%2FBoltConn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FXOR-op%2FBoltConn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXOR-op%2FBoltConn/lists"}