\n \nunbox

\n
\n\nUnbox is a CLI tool for [sing-box](https://github.com/SagerNet/sing-box) that has commands: \n1. `examples`: Show usage examples\n2. `conf`: Works with sing-box config file to\n - [Deduplicate](https://github.com/aceberg/unbox#deduplicate) (compares all fields but `tag`)\n - [Convert sing-box config outbounds to URLs](https://github.com/aceberg/unbox#convert-sing-box-config-outbounds-to-urls)\n - [Remove unreachable nodes from sing-box config file](https://github.com/aceberg/unbox#remove-unreachable-nodes-from-sing-box-config)\n3. `keep`: [Keep connection alive, auto switch proxy](https://github.com/aceberg/unbox#keep-connection-alive-and-switch-if-not)\n4. `parse`: [Convert file with URLs to sing-box config](https://github.com/aceberg/unbox#convert-file-with-urls-to-sing-box-config)\n\nSupported URLs: `vless://`,`hysteria2://` or `hy2://`,`trojan://` \nExperimental: `anytls://`, `ss://`, `tuic://`\n\n\n\n## Screenshot\n\n

Expand

\n\n![Screenshot_1](https://raw.githubusercontent.com/aceberg/unbox/main/assets/Screenshot_1.png) \n

\n\n## Install\n

Expand

\n\n### Docker\nExample `keep` command with sing-box Clash API:\n```sh\ndocker run aceberg/unbox keep -a \"http://192.168.0.11:9090\"\n```\nOr use `ghcr.io/aceberg/unbox`\n\n### Binary\nAll available binaries are listed in the [latest](https://github.com/aceberg/unbox/releases/latest) release. \nFor `amd64` there is an `apt` [repo](https://github.com/aceberg/ppa).\n\n### Android and Termux\nFor `arm64` there are `android` and `termux.deb` [files](https://github.com/aceberg/unbox/releases/latest).\n

\n\n## Deduplicate\n

Expand

\n\n```sh\nunbox conf -d -o sing-box.json\n```\n\n| Key | Description | Default |\n| --- | ----------- | ------- |\n| -d | Deduplicate | |\n| -o | Path to sing-box config file | |\n\n

\n\n## Convert sing-box config outbounds to URLs\n

Expand

\n\n```sh\nunbox conf -i sing-box.json > URLs.txt\n```\n\n| Key | Description | Default |\n| --- | ----------- | ------- |\n| -i | Path to sing-box config file | |\n\n

\n\n## Remove unreachable nodes from sing-box config\n

Expand

\n\n```sh\nunbox conf -a \"http://127.0.0.1:9090\" -o sing-box.json\n```\n\n| Key | Description | Default |\n| --- | ----------- | ------- |\n| -a | URL of sing-box Clash API | |\n| -as | Clash API secret | |\n| -l | Timeout for proxy delay (latency) check (ms) | 3000 |\n| -n | Number of best servers to save (0 - save all) | 0 |\n| -o | Path to sing-box config file | |\n| -tlsh | Host to verify TLS certificate | github.com |\n| -tlsp | SOCKS5 proxy address for TLS check (example \"127.0.0.1:1080\") | |\n| -u | URL to test proxies. `https://www.gstatic.com/generate_204` will be used if empty | |\n\n

\n\n## Keep connection alive and switch if not\n

Expand

\n\n```sh\nunbox keep -a \"http://127.0.0.1:9090\"\n```\n\n| Key | Description | Default |\n| --- | ----------- | ------- |\n| -a | URL of sing-box Clash API | |\n| -as | Clash API secret | |\n| -da | Delay between checks of all proxy servers (seconds). Use 0 to disable | 300 |\n| -db | Delay between checks of 4-5 backup servers (seconds). Use 0 to disable | 30 |\n| -dm | Delay between checks of the main server (seconds). Use 0 to disable | 5 |\n| -ds | Delay between auto switch to a faster proxy attempts (seconds). Use 0 to disable | 300 |\n| -l | Timeout for proxy delay (latency) check (ms) | 3000 |\n| -n | Number of backup servers | 5 |\n| -st | Switch to a faster proxy if it is at least this many ms faster than the current one (ms) | 50 |\n| -u | URL to test proxies. `https://www.gstatic.com/generate_204` will be used if empty | |\n\n\n

\n\n## Convert file with URLs to sing-box config\n

Expand

\n\nHere `VLESS.txt` is a file with `vless://`,`hysteria2://`,`trojan://` links. Unbox will ignore anything else in the file, including other protocols and comments.\n```sh\nunbox parse -f VLESS.txt\n```\nIn this example `tmpl.json` is a [template](https://github.com/aceberg/unbox/blob/main/configs/sing-box.tmpl.json) sing-box config and `sing-box.json` is where unbox will put generated config.\n```sh\nunbox parse -f VLESS.txt -t tmpl.json -o sing-box.json -j\n```\n\n| Key | Description | Default |\n| --- | ----------- | ------- |\n| -f | Path to file with URLs | VLESS.txt |\n| -j | Validate and Indent JSON output | |\n| -n | Rename tags. If used, will rename tags to `tag1`, `tag2`... | |\n| -o | Path to output sing-box config file | |\n| -p | Prefix to add before each tag | |\n| -t | Path to template sing-box config. Example [here](https://github.com/aceberg/unbox/blob/main/configs/sing-box.tmpl.json). There are only two variables available in template: `{{ .Unbox_tags }}` and `{{ .Unbox_outbounds }}` | |\n

\n\n## Thanks\n\n- [SagerNet/sing-box](https://github.com/SagerNet/sing-box)\n- Unboxing icons created by Futuer - Flaticon","has_starred","hub_user","immutable_tags_settings",{"_179":11,"_180":181},"enabled","rules",[182],".*","is_automated","permissions",{"_186":17,"_187":11,"_188":11},"read","write","admin","user","storage_size",293691473,"isOrg","reponame","tag","canDeleteTags","isHubSbxKitsEnabled","currentTab","tagAttestations","displaySecurityMetadata","showSbxLogoOverride","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)._index",{"_23":24,"_138":-7,"_136":-7,"_137":-7,"_25":203,"_31":59,"_209":210,"_216":11},{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":204,"_76":77,"_78":30,"_79":80,"_81":82,"_83":84,"_85":86,"_87":72,"_88":77,"_89":55,"_90":17},[205,206,207,208],{"_40":41,"_31":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":44,"_52":-5,"_53":34,"_54":55,"_56":-5},{"_40":58,"_31":59,"_43":44,"_45":60,"_47":61,"_49":50,"_51":44,"_52":-5,"_53":62,"_54":55,"_56":-5},{"_40":64,"_31":65,"_43":44,"_45":66,"_47":67,"_49":50,"_51":44,"_52":-5,"_53":68,"_54":55,"_56":69},{"_40":64,"_31":71,"_43":44,"_45":72,"_47":73,"_49":50,"_51":44,"_52":-5,"_53":74,"_54":55,"_56":75},"imageWithLayers",{"_40":58,"_31":59,"_43":44,"_45":60,"_47":61,"_94":211,"_49":50,"_51":44,"_52":-5,"_53":62,"_54":55,"_56":-5},[212,213,214,215],{"_31":97,"_53":98,"_99":100},{"_31":102,"_53":103,"_99":104},{"_31":133,"_53":134,"_99":108},{"_53":110,"_99":111,"_31":44},"hasPermissionToViewRepoSettings","actionData","errors"]

aceberg/unbox:1.0.5