SagerNet / SagerNet/sing-box

Idk

Open
#4,467 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
38.2k
Forks
4.6k
Avg merge
19d 15h
Merged PRs (30d)
1

Description

[Android 16 / HyperOS 3] configure tun interface: invalid argument (Xiaomi 13T)

Operating system

Android

System version

Android 16, Xiaomi 13T, HyperOS 3

Installation type

sing-box for Android Graphical Client

Client version

1.14.0-rc.3

Description

start or reload service: start inbound/tun[tun-in]: configure tun interface: invalid argument

This occurs immediately when starting the VPN with a TUN inbound, on every
attempt, regardless of the stack value used (tested system, gvisor,
and mixed — identical error every time).

Reproduction

{
"log": { "level": "debug" },
"dns": {
"servers": [
{ "tag": "dns-direct", "type": "udp", "server": "1.1.1.1" }
],
"final": "dns-direct"
},
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"interface_name": "tun0",
"address": [ "172.19.0.1/30" ],
"auto_route": true,
"strict_route": false,
"stack": "mixed",
"mtu": 1500
}
],
"outbounds": [
{ "type": "direct", "tag": "direct" }
],
"route": {
"auto_detect_interface": true,
"final": "direct"
}
}

Additional notes
  • VPN permission is granted successfully; the error happens right after,
    during tun configuration.
  • Disabling "MIUI/HyperOS optimization" in Developer options did not help.
  • Disconnecting any other active VPN app on the device did not help.
  • Tested with a minimal direct-only outbound (as above) to rule out any
    proxy/server-related cause — same result.
  • This is a brand new device/OS combination (HyperOS 3, Android 16), so this
    may be a new incompatibility with this specific kernel/TUN driver version.
Integrity requirements
  • I confirm that I have read the documentation, understand the meaning of all the configuration items I wrote, and did not pile up seemingly useful options or default values.
  • I confirm that I have provided the simplest configuration that can be used to reproduce the error I reported.
  • I confirm that I have provided the complete configuration files and logs.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the supplied minimal TUN configuration on Android 16/HyperOS 3 with a Xiaomi 13T, then trace the TUN setup path that reports “configure tun interface: invalid argument.” Compare behavior across the tested stack values and verify the fix by starting or reloading the service successfully with the listed configuration.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, go
Domain
networking, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.