Skip to content

build: upgrade tuic-core to v1.8.4#1431

Merged
Itsusinn merged 8 commits into
masterfrom
build/tuic
May 19, 2026
Merged

build: upgrade tuic-core to v1.8.4#1431
Itsusinn merged 8 commits into
masterfrom
build/tuic

Conversation

@Itsusinn
Copy link
Copy Markdown
Member

@Itsusinn Itsusinn commented May 19, 2026

Upgrade tuic-core from branch-based dependency (build/tuic) to v1.8.4 tag.

Changes in Itsusinn/tuic v1.8.4:

  • Restore public re-exports of quinn types/submodules from tuic_core::quinn
  • Restore quinn-congestions dependency and feature flags (quinn/rustls-ring, quinn/rustls-aws-lc-rs, runtime-tokio)

Congestion controller update:

  • bbr: now uses BbrConfig from quinn-congestions (instead of incorrectly using built-in Bbr3Config)
  • bbr3: new option, uses Quinn built-in Bbr3Config

Tested: cargo build passes

Summary by CodeRabbit

  • New Features
    • Added support for an additional QUIC congestion controller variant ("bbr3") and enabled BBR configuration for TUIC transport.
  • Chores
    • Switched a core dependency from a development branch to a stable release tag.
    • Added a patch configuration entry.

Review Change Stack

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 19, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 3c811112-a817-4bad-8184-66d8923251d1

📥 Commits

Reviewing files that changed from the base of the PR and between 3276f1d and 8a8793c.

📒 Files selected for processing (1)
  • clash-lib/src/proxy/tuic/mod.rs

📝 Walkthrough

Walkthrough

Pins tuic-core to tag v1.8.4, adds a newline to the root Cargo.toml patch section, wires QUIC transport to use BbrConfig::default() for BBR, and adds a Bbr3 congestion-control variant with string parsing for "bbr3".

Changes

Dependency and TUIC updates

Layer / File(s) Summary
tuic-core version pinning
clash-lib/Cargo.toml, Cargo.toml
tuic-core Git dependency switched from branch = "build/tuic" to tag = "v1.8.4", and root Cargo.toml adds a newline after [patch.crates-io] entries.
BBR congestion-controller wiring
clash-lib/src/proxy/tuic/mod.rs
Adds bbr::BbrConfig import and sets the Quinn transport congestion-controller factory to BbrConfig::default() for the CongestionControl::Bbr branch.
Bbr3 enum and parsing
clash-lib/src/proxy/tuic/types.rs
Adds Bbr3 variant to CongestionControl and extends From<&str> to map "bbr3" to CongestionControl::Bbr3.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • ibigbug

Poem

🐰 A hop, a tag, a tweak in thread,
BBR wakes, new routes to tread,
v1.8.4 set the chain,
bbr3 joins the train,
Code carrots crunchy, joy ahead!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main change: upgrading the tuic-core dependency to v1.8.4, which is the primary alteration across all modified files.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 19, 2026

Codecov Report

❌ Patch coverage is 25.00000% with 3 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
clash-lib/src/proxy/tuic/types.rs 0.00% 2 Missing ⚠️
clash-lib/src/proxy/tuic/mod.rs 50.00% 1 Missing ⚠️

📢 Thoughts on this report? Let us know!

- Bbr: quinn-congestions BbrConfig (quinn-congestions)
- Bbr3: quinn built-in Bbr3Config
- keep Bbr as default
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@clash-lib/src/proxy/tuic/mod.rs`:
- Around line 14-18: The tuic_core::quinn use block is misformatted for
rustfmt/CI: reorder and reflow the imported symbols (QuinnConfig, QuinnEndpoint,
EndpointConfig, TokioRuntime, QuinnTransportConfig, VarInt, bbr::BbrConfig,
congestion::{Bbr3Config, CubicConfig, NewRenoConfig},
crypto::rustls::QuicClientConfig) to follow rustfmt and ASCII case-sensitive
import ordering (upper-case before lower-case) and then run cargo +nightly fmt
--all to apply the correct formatting; ensure the multi-line use statement is
wrapped and aligned per rustfmt so CI fmt check passes.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 09ca4394-9901-443a-8a70-b521a4028c4f

📥 Commits

Reviewing files that changed from the base of the PR and between 05fa307 and 3276f1d.

📒 Files selected for processing (2)
  • clash-lib/src/proxy/tuic/mod.rs
  • clash-lib/src/proxy/tuic/types.rs

Comment thread clash-lib/src/proxy/tuic/mod.rs
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 19, 2026

📊 Proxy Throughput Results

Shadowsocks

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
plain 32 MB 3 12698.3 ±2363.6 13491.4 ±2589.9
obfs-http 32 MB 3 17478.0 ±9713.3 14127.1 ±1279.8
obfs-tls 32 MB 3 9710.1 ±2796.3 10778.0 ±1666.2
shadow-tls-v3 32 MB 3 10465.9 ±2568.2 9064.6 ±2708.7
v2ray-plugin-ws-tls 32 MB 3 14560.8 ±3477.4 15467.6 ±2065.2

Trojan

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
tcp 32 MB 3 11140.3 ±2695.3 11142.4 ±881.9
ws 32 MB 3 14728.6 ±7861.5 12163.6 ±2391.0
grpc 32 MB 3 10679.4 ±1372.5 11726.1 ±2781.4

VMess

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
tcp 32 MB 3 12299.1 ±1074.3 12771.8 ±482.1
tcp-tls 32 MB 3 17884.8 ±249.8 16943.8 ±813.4
ws 32 MB 3 16239.0 ±8911.5 13036.2 ±363.5
h2 32 MB 3 14506.3 ±2939.7 12793.6 ±2964.4
grpc 32 MB 3 12823.0 ±2984.2 13525.9 ±1710.0

VLESS

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
tcp 32 MB 3 9620.9 ±2620.9 10514.8 ±2399.7
ws 32 MB 3 13610.1 ±1674.4 11681.5 ±1005.1
h2 32 MB 3 11203.9 ±1805.7 9056.9 ±447.1
grpc 32 MB 3 9007.7 ±5337.9 16275.3 ±2503.8

SOCKS5

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
auth 32 MB 3 12178.8 ±2586.9 8593.4 ±3248.0
noauth 32 MB 3 13182.0 ±2383.6 13504.8 ±1060.6

AnyTLS

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
tls 32 MB 3 13055.8 ±433.5 13936.8 ±1516.9

Hysteria2

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
plain 32 MB 3 13854.5 ±122.4 13278.0 ±422.0
salamander 32 MB 3 13699.1 ±846.0 12768.2 ±481.1

TUIC

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
bbr 32 MB 3 14319.5 ±1585.4 13722.7 ±1475.2
cubic 32 MB 3 14043.8 ±4324.3 13610.0 ±4176.8
new_reno 32 MB 3 12736.8 ±1897.1 11878.3 ±1792.5

ShadowQUIC

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
plain 32 MB 3 12853.0 ±8077.4 11803.0 ±2579.5
over-stream 32 MB 3 12978.5 ±1777.9 14281.7 ±2856.0

SSH

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
password 32 MB 3 7967.2 ±4637.2 9431.7 ±3227.3
ed25519 32 MB 3 10300.4 ±1292.8 9545.9 ±585.1

Netem Tests (50 ms delay, 1% packet loss)

Shadowsocks

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
plain-netem 32 MB 3 13313.3 ±1978.7 13335.0 ±819.6

Trojan

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
tcp-netem 32 MB 3 14054.0 ±2076.9 14877.5 ±1461.6

Hysteria2

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
plain-netem 32 MB 3 13849.3 ±1067.7 12794.4 ±669.0

TUIC

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
bbr-netem 32 MB 3 12540.6 ±4080.2 13524.3 ±2994.9

ShadowQUIC

Transport Payload Runs Upload Mbps (±σ) Download Mbps (±σ)
plain-netem 32 MB 3 12828.0 ±6822.6 14488.2 ±1026.7

Ran 34 variant(s) in parallel; each direction transfers the full payload.

🖥️ Test Environment

OS Linux 6.17.0-1013-azure
Architecture x86_64
Kernel 6.17.0-1013-azure
CPU AMD EPYC 9V74 80-Core Processor
CPU Cores 4
Memory 15.61 GB
Docker 28.0.4
Rust rustc 1.95.0 (59807616e 2026-04-14)

📎 View full workflow run and download artifacts

Full test log

Download the throughput-results artifact from the workflow run for the full log.

@Itsusinn Itsusinn enabled auto-merge (squash) May 19, 2026 19:45
@Itsusinn Itsusinn merged commit 0f7b055 into master May 19, 2026
35 of 36 checks passed
@Itsusinn Itsusinn deleted the build/tuic branch May 19, 2026 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants