Currently, if system /usr/share/v2raya/geosite.dat is used, v2raya will
not post error, but will display "none" for local GFWList date.
Since v2rayA reads this compatible file, we should display a date for
it, so that user is not confused.
Assisted-by: GPT-5.6-terra
A menu button by the brand folds the standard drawer; the rail that
replaces it is the one the medium window already uses, with the same
menu button at the top to unfold. The choice is kept in localStorage.
The theme panel had its own hue slider and hex field for a custom seed.
v-color-picker in hex mode gives the canvas, the hue slider and the hex
input, so the slider, the hex parsing and their styles go.
useUnsavedGuard registers beforeunload while a component with unsaved edits is mounted.
The settings model keeps the snapshot it loaded or saved, so the page knows when the
form differs; the RoutingA editor already compares its text with the original.
Six pages each under gui/src/docs/{fa,ko,pt,ru}/, named after the i18n locale keys so
docs/index.ts picks them up. Headings, code blocks and inline code are identical to the
English pages; bold UI labels are the locale's own strings; log messages stay in English.
Inline code in the docs body is now an LTR isolate that does not wrap, and code blocks
are LTR, so paths and flags keep their order in the Persian pages.
A daily job lists open issues not updated for 60 days, except those labeled
notice or enhancement, and closes up to 100 of them as not planned with a
comment; there are 220 such issues today, the oldest from 2024.
Node hostnames, upstream hostnames and the service's own lookups (subscriptions,
latency tests) were resolved by hard-coded public resolvers (223.5.5.5, 119.29.29.29,
...) whatever the DNS rules said; the second nameserver written into the hijacked
/etc/resolv.conf was hard-coded too. directDnsServers() now collects the plain
udp/tcp IP upstreams of the rules with the direct outbound, and
- resolv.PreferredServers hands them to the service's resolver before its public list
- the module's bootstrap_dns is the system's resolvers plus those upstreams
- the upstream for node hostnames is the first of them
- HijackResolv writes the first port-53 one as the second nameserver, and so does the
restore when no backup exists
getSystemDnsServers reads the backup while resolv.conf is hijacked, so a restart
no longer hands the module its own listener as bootstrap.
The DNS module spoke UDP, TCP and DNS over TLS. An https:// upstream is
now an RFC 8484 POST through an http.Client the upstream keeps between
queries; the TLS handshake is done in the dialer so the server name is
the upstream's hostname while the address dialled is what bootstrap
resolved for it — the module cannot ask itself for its own upstream's
address. A direct upstream dials on a marked socket, as the other
protocols do; a proxied one dials through the xray dispatcher, so the
request leaves through the chosen outbound.
Two things the dispatcher path had wrong for tls:// upstreams: it sent
plain DNS over TCP whatever the protocol, and bootstrap replaced the
hostname by an IP without keeping it, so TLS had nothing to verify
against. The hostname is kept as ServerName on the upstream, the
dispatcher path wraps the connection in TLS for tcp-tls, and the direct
miekg client verifies the same name. The service adds https and tls
hostnames to the bootstrap list, which it skipped for every scheme
address before. CheckDnsUpstream accepts https:// URLs with a host and
still refuses quic://.
Verified on the VM with a raw UDP client against the module, names not
in its cache: https://dns.google/dns-query direct (bootstrap dns.google
→ 8.8.8.8, a v2raya_core connection to 8.8.8.8:443), https://1.1.1.1
/dns-query via proxy (the connection goes to the proxy server's :443),
tls://dns.google via proxy (rewritten to 8.8.8.8:853, TLS verified as
dns.google) and tls://1.1.1.1 direct all answer; the previous rules
restore unchanged. A unit test runs the DoH client against an httptest
TLS server.
The DNS form's placeholder offered https://dns.google/dns-query, the
service turned https:// into protocol "https" and quic:// into "quic",
and the DNS module handed those to a miekg/dns client, which speaks udp,
tcp and tcp-tls only. Saving succeeded and every query on that rule then
failed, visible only in the log.
CheckDnsUpstream in kernel/v2ray accepts an address, tcp://, udp:// and
tls:// (DNS over TLS, which the module does support) and rejects https://
and quic:// with a message that names the alternatives; PutDnsRules
returns it as a 400 before anything is stored. The placeholder in the six
locales shows the supported forms and the docs say which schemes work.
Verified on the VM: https:// and quic:// rules come back BAD_REQUEST with
the message, tls://1.1.1.1 saves and the module logs
addr=1.1.1.1:853 protocol=tcp-tls; the previous rules restore unchanged.
RoutingA could be opened from the dashboard's splitting tile (labelled
"RoutingA"), the proxies page's toolbar ("RoutingA rules"), the settings
row ("RoutingA rules" since the previous commit) and the tutorial. The
label is "RoutingA rules" everywhere it remains, and the proxies page
loses its button: rules are not a property of the node list, and the
dashboard tile that chooses the splitting mode and the settings row are
where a user looks for them.
The lint carried five warnings into every CI run: two unused imports in
AppShell.vue, one in a spec, a let that never changes, and v-html in the
log view, whose input highlight.js escapes.
The templates sat at the end of the syntax reference, behind five
collapsed sections, and the settings row and dialog were titled by the
bare name RoutingA. The dialog header now has a Templates menu next to
the reference button, in two groups: four full rule sets that replace the
rules after a confirmation (China direct; sites outside China through
the proxy; everything through the proxy; only common foreign services
through the proxy) and thirteen additions inserted at the cursor (ads,
streaming, social media, Telegram, AI, developer services, Chinese
endpoints of Apple/Google/Microsoft/Steam, Apple and Microsoft direct,
game platforms, speed tests, LAN, BitTorrent direct, block QUIC). The
reference is a syntax reference again. The settings row and the dialog
are titled "RoutingA rules" in every locale.
Every template uses only v2fly geosite/geoip categories and the three
built-in outbounds; a spec runs each through the editor's checker, and
on the VM each of the seventeen applied through the API while the core
was running.
The app bar's status button carries the spacing to the group button
itself: the class on the OutboundMenu component landed on the menu, not
its activator, so the two sat flush at every width below 1200.
A read of the tree for home-grown code that a dependency or the platform
covers. Each item names what replaces it.
- IPv4 CIDR membership was a binary-string trie (infra/dataStructure/trie)
fed with CIDRs rendered as bit strings; net.IPNet.Contains, which the
same file already used for IPv6, does it. The trie package is gone.
- The response replay cache was an LRU with its own linked list, indexes
and timeout strategy (infra/dataStructure/lru), of which one fixed-size
instance existed; hashicorp/golang-lru/v2, already in go.mod, is that
cache, typed. go mod tidy also dropped go-nanoid, which nothing imported.
- The HTTP client for subscription updates through the local proxy carried
a CONNECT dialer of its own (pkg/util/proxyWithHttp); http.Transport's
Proxy handles socks5:// and http:// URLs, resolves hostnames on the
SOCKS proxy and uses CONNECT for https. Verified on the VM: a
subscription update succeeds in both "pac" and "proxy" modes.
- core/dns/qtype.go listed nine type names in two switches before falling
back to miekg/dns tables that contain the same names; dns.Type.String
and dns.StringToType are the tables.
- The GUI tracked prefers-color-scheme with its own media query and
toggled a theme-dark class nothing reads any more; Vuetify's "system"
theme follows the OS itself. Verified in headless Chrome: auto follows
the OS in both directions, an explicit choice overrides it.
- The AUR packages carried .INSTALL hooks whose only content was a
coloured "Completed!" banner, duplicated in the deb/rpm after-install
scripts; pacman and apt report that themselves. The hooks are gone, the
release workflow stops copying them, and after_install/after_upgrade
keep only daemon-reload and the restart.
- The tap release job downloaded eight artifacts in eight steps;
actions/download-artifact takes a pattern with merge-multiple.
The scripts backgrounded v2raya with start-stop-daemon and a pidfile,
and stop_post ran pkill -x v2raya_core to catch a core that outlived a
killed service, which also took the cores of v2raya-user.<user>
instances. Under supervise-daemon the service sits in its own process
group and cgroup: a stop takes the core with it, and a crash respawns
the service, whose start kills an orphaned core holding the ports
itself. stop_post is gone.
v2raya-user.initd ran checkpath on ~/.config/v2raya, which fails on an
account that has no ~/.config yet ("could not open .config"), so a fresh
user could not start the service; checkpath makes one level at a time,
and ~/.config is created first.
The conf.d defaults passed --log-disable-timestamp together with
--log-file, and the flag is ignored whenever a log file is set; the
default now names the log file alone and says why. The descriptions say
what v2rayA is today, and the --lite help line matches the binary.
Verified on the Gentoo VM (OpenRC 0.63): stop clears the 51 tproxy
rules, the fwmark rule and the core; start restores them; kill -9 of
v2raya is followed by a respawn within seconds, the orphaned core is
killed by the new instance and the dashboard reports it running; a
v2raya-user.tuser instance for a new account starts as that user,
survives a system service stop, and stops cleanly.
The core's asset directory defaulted to v2raya/ under the XDG runtime
directory, and the lookup created the links there with xdg.RuntimeFile.
A service user has no session, so /run/user/<uid> does not exist and the
user cannot create it; the first lookup failed with "could not create any
of the following paths: /run/user/1001/v2raya" and the start died, while
geoip.dat and geosite.dat sat in /usr/share/v2raya. That is every
OpenRC v2raya-user.<user> instance and any lite start outside a desktop
session. When the runtime directory cannot be made, the configuration
directory, which the process owns, holds the links instead.
Verified on the Gentoo VM: /etc/init.d/v2raya-user.tuser starts, reports
lite and links /usr/share/v2raya/*.dat into ~/.config/v2raya.
The macOS section told the reader to stop the brew service and run the
binary under sudo by hand to get tun. With v2rayA/homebrew-v2raya#7 the
tap's service is one file for both identities, so the section shows the
two commands and what each gives, plus how a sudo-started service is
stopped and Homebrew's ownership warning. The requirement rows say that
an unprivileged start is lite mode by itself, as #2011 made it.
With no subscriptions, the Proxies page showed a card the height of a
screen: a large RSS icon, the import dialog's prompt "Input a subscription
address:" as if it were a caption, and a tonal button in the default
colour that read as disabled. It is now one row on a low surface: the
icon, "No subscriptions yet" with a line on what a subscription does, and
a primary tonal button that opens the import dialog already switched to
Subscription address, so the user does not pick the kind again. The same
button in the dashboard's subscription tile opens that way too; the
Import dialog takes the kind as a prop. The node list's own empty state
said the same wrong prompt and now says what to import.
A start as an ordinary user without --lite died on Linux and Windows
with a message telling the user to add --lite, and on macOS with a
failure to write /etc/v2raya. Nothing that needs root works without it
anyway, so the flag only chose the configuration directory and the
dashboard's options; the binary can decide that from its own privileges.
Lite mode is now implied when the process is not root or an
administrator, with one warning in the log, and --lite keeps working. A
service definition can then be a single file for both ways of running:
brew services and a systemd user unit start the same command as root for
the transparent proxy or as the user for the system proxy. The root
checks in pre_environment.go became unreachable and are gone;
--passcheckroot keeps its meaning.
The v4 import consulted the v4 library on every fresh start. That library
parses the command line itself and opens boltv4.db under its own default
directory, /etc/v2raya, creating the file when the directory exists and
dying when it does not, which an unprivileged start without --lite hit at
once. It is now asked only when boltv4.db exists in the configuration
directory, which also stops a fresh root install from growing an empty
boltv4.db.
Verified: macOS (arm64) and the Linux VM as an unprivileged user without
--lite start in lite mode with the user's configuration directory and
report lite: true, isRoot: false; the VM service as root is unchanged.
Inspect bound_dev_if at connect time, preserve existing socket marks and
add the existing 0x80 bypass bit before REDIRECT. Scope the guard to the
manager's network namespace and release real BPF links on teardown.
Include opt-in isolated cgroup tests and document the experimental status,
unverified native behavior, performance work, and connect-time limits.
A source review of the six sections found statements the code does not
support. Corrected: the plain SOCKS and HTTP inbounds always route through
proxy, only the rule port follows the splitting mode; a bare domain()
value is a substring match, domain: is the suffix match; a custom
inbound's RoutingA text takes rules only, default: and outbound: are
ignored and the form's group is the fallback; a DNS rule's localhost is
127.0.0.1:53, and any outbound other than direct goes through the SOCKS
inbound; redirect sends port 53 to the DNS module's 52353 and a busy port
53 is skipped, not fatal; the core hook also gets --v2raya-confdir, and
manual TUN routes are the Configure Route Script setting, not the hook;
pinning a member is the node menu, Edit group changes members; settings
apply on Save and Apply; greatfire is in v2fly's list; a missing geoip
category is "illegal ip rule"; GFWList mode needs Update GFWList first
and downloads from v2rayA/dist-v2ray-rules-dat; rule data is searched in
the XDG data directories; the user unit and the Windows installer log
elsewhere; CORE_START_FAILED also covers a launch failure and the API
timeout; TIMEOUT is a failed TCP connect; registration asks for a 6–32
character password; import needs the kind chosen; port 0 on the API
means random and Port Sharing leaves it on loopback.
Every step of the tutorial links its documentation section. The status
button stops reserving room for the long "Waiting for network" label,
which made it wide on phones; that label widens it only while shown. The
English navigation label reads "Settings", and the two Chinese labels
quoted in the docs get their spaces (更新 GFWList, 开启 IP 转发).