\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",{"_206":11,"_207":208},"enabled","rules",[209],".*","is_automated","permissions",{"_213":21,"_214":11,"_215":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",{"_27":28,"_165":-7,"_163":-7,"_164":-7,"_29":230,"_35":75,"_240":241,"_247":11},{"_31":32,"_33":34,"_35":36,"_37":38,"_39":40,"_41":231,"_99":100,"_101":34,"_102":103,"_104":105,"_106":107,"_108":109,"_110":83,"_111":100,"_112":59,"_113":21},[232,233,234,235,236,237,238,239],{"_44":45,"_35":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":-5,"_57":38,"_58":59,"_60":-5},{"_44":62,"_35":63,"_47":48,"_49":64,"_51":65,"_53":54,"_55":48,"_56":-5,"_57":66,"_58":59,"_60":-5},{"_44":68,"_35":69,"_47":48,"_49":70,"_51":71,"_53":54,"_55":48,"_56":-5,"_57":72,"_58":59,"_60":73},{"_44":68,"_35":75,"_47":48,"_49":76,"_51":77,"_53":54,"_55":48,"_56":-5,"_57":78,"_58":59,"_60":79},{"_44":81,"_35":82,"_47":48,"_49":83,"_51":84,"_53":81,"_55":48,"_56":-5,"_57":85,"_58":59,"_60":-5},{"_44":81,"_35":87,"_47":48,"_49":88,"_51":89,"_53":81,"_55":48,"_56":-5,"_57":85,"_58":59,"_60":-5},{"_44":81,"_35":91,"_47":48,"_49":92,"_51":93,"_53":81,"_55":48,"_56":-5,"_57":94,"_58":59,"_60":-5},{"_44":81,"_35":96,"_47":48,"_49":97,"_51":98,"_53":81,"_55":48,"_56":-5,"_57":94,"_58":59,"_60":-5},"imageWithLayers",{"_44":68,"_35":75,"_47":48,"_49":76,"_51":77,"_117":242,"_53":54,"_55":48,"_56":-5,"_57":78,"_58":59,"_60":79},[243,244,245,246],{"_35":120,"_57":121,"_122":123},{"_35":125,"_57":126,"_122":127},{"_35":140,"_57":141,"_122":131},{"_57":133,"_122":134,"_35":48},"hasPermissionToViewRepoSettings","actionData","errors"]

aceberg/unbox:0.3.1