Repository navigation
Releases: iXhong/singboxctl
Releases · iXhong/singboxctl
Release list
singboxctl v0.1.1
Fixed
- Generated systemd units no longer quote
WorkingDirectory=, which systemd
treated as a non-absolute path and refused to load.
singboxctl v0.1.0
Added
- Initial standalone release.
- Python packaging (
pyproject.toml) with asingboxctlconsole entry point,
installable viapip,pipx, oruv tool. - Runtime config directory resolution (
$SINGBOXCTL_CONFIG_DIRor
~/.config/singboxctl), so real profiles live outside the repo. --versionflag.- Example profile shipped in
configs/examples/. - CI workflow that runs
sing-box checkagainst example profiles. - Local dev launcher (
./singboxctl) usable without installation. - Read-only
singboxctl doctordiagnostics for the sing-box executable,
configuration directory, profiles, active profile, validation, and profile
permissions. singboxctl setupinstalls an owned systemd user unit using the discovered
sing-box executable and resolved config directory without starting the proxy;
login autostart is opt-in with--enable.- Explicit legacy-unit migration with
setup --migrateand safeuninstall
removal of recognized service/helper artifacts while preserving profiles. - Distribution-content validation and isolated wheel/source-archive smoke tests.
- Project metadata links for documentation, source, issues, and changelog.
- Tag-driven GitHub Releases with verified artifacts, checksums, and changelog
release notes; PyPI publication remains disabled.
Fixed
- Clash API requests now bypass
http_proxy/https_proxyenv vars, so
nodeandcurrentwork even when a system proxy is configured
(previously the loopback API call was tunnelled through the proxy and
returned502 Bad Gateway).
Changed
./install.shis now a thin compatibility wrapper that installs the package
withuv toolorpipx(checkout-independent) and runssingboxctl setup,
instead of building a checkout-local virtualenv and symlinks. Installer
precedence is uv, then pipx; only--enableand--migrateare forwarded.- README documents
uv tool install/pipx installas the primary install
paths and explicituv tool upgrade/pipx upgradeworkflows; upgrades are
never run automatically during setup. - The systemd unit template and example profiles ship as package data in wheels
and source archives. - Package metadata, module output, and CLI output now share the version declared
insingboxctl.__version__; development tooling includes reproducible builds. - Migration messages now also report detected checkout-local
singboxctland
proxy-*command links with safe removal steps.
Deprecated
- The
proxy-*helper aliases are deprecated in favor of the canonical
singboxctlcommands; the wrapper files remain as forwarding shims for one
compatibility window and receive no new features.
Removed
- The installer no longer creates
~/.local/bin/singboxctlorproxy-*
symlinks from the Git checkout.
Security
- The example proxy inbound now listens on loopback, active profile links are
checked for broken or escaping targets, and broadly readable profiles produce
an advisory warning without being modified.