Linux Scripts Collection

面向 Debian 与 Ubuntu VPS 的系统初始化、网络调优、运行时配置和日常运维脚本集合。

脚本会修改系统配置、安装软件包或管理服务。使用前请阅读对应说明并备份重要数据；生产环境建议先在相同发行版与版本的测试机验证。

支持范围

一键部署与模块：Debian 12 或更高版本、Ubuntu 22.04/24.04，Bash，systemd，root 权限；
Ubuntu 需启用发行版软件源中的 universe，否则 Zram 或 Speedtest 等软件包可能不可用；
Ubuntu 22.04（Jammy）不在 XanMod 官方 APT 支持范围内，内核步骤会安全跳过；
独立工具：以脚本顶部说明为准；大部分面向 Debian/Ubuntu 系统；
xanmod-install.sh：主要面向 amd64/x86-64；
CI 在 Ubuntu 24.04 和 Debian 13 容器运行全部纯 Shell 测试；systemd 服务切换使用 stub 验证事务与回滚，不等同于真实主机 E2E；
需要访问 GitHub、系统 APT 软件源和各工具的上游服务。

快速开始

推荐直接远程运行最新主脚本。脚本需要交互输入，因此使用进程替换，避免将标准输入占用为脚本内容：

sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/linux_setup.sh)

如需先审阅再执行：

curl -fsSLo /tmp/linux_setup.sh \
  https://raw.githubusercontent.com/LucaLin233/Linux/main/linux_setup.sh
less /tmp/linux_setup.sh
sudo bash /tmp/linux_setup.sh

需要修改脚本或离线保留副本时，再克隆仓库：

git clone https://github.com/LucaLin233/Linux.git
cd Linux
sudo ./linux_setup.sh

运行过程中可能安装软件、修改 sysctl、SSH、Shell、定时任务和 systemd 服务。不要在未备份、无控制台或无法接受中断的生产机上直接选择全部安装。

Linux 一键部署

linux_setup.sh 是主要入口。它会：

检查 Debian/Ubuntu 版本、root、磁盘和网络；
安装基础依赖并更新软件包索引；
获取 GitHub 最新 Commit；
从该固定 Commit 自动发现、下载和校验 modules/*.sh；
解析模块顺序和依赖，执行全部或用户选择的模块；
写入部署日志和摘要。

常用选项：

sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/linux_setup.sh) --check-status
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/linux_setup.sh) --clean-cache
bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/linux_setup.sh) --version
bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/linux_setup.sh) --help

主要文件：

/var/log/linux-setup.log
/root/deployment_summary.txt
/var/cache/linux-setup/

部署模块

菜单编号	模块	功能	主要影响
1	`system-optimize.sh`	Zram、系统 sysctl、journald、THP、时区和 Chrony	为 headless VPS 设置 Panic 恢复、日志上限和低干扰 THP 策略；Ubuntu 可能安装内核模块、固件与 CPU 微码
2	`system-customize.sh`	动态 MOTD、中文 Locale、可选 XanMod	可能修改 Locale、欢迎信息和内核
3	`network-optimize.sh`	BBR、fq、按需禁用 ECN、动态 TCP/UDP 缓冲区、IPv4/IPv6 转发	交互时先询问是否测速，拒绝后手填带宽；单方向 40 GB 或合计 85 GB 时提前停止；保留云平台 IPv6 RA
4	`zsh-setup.sh`	Zsh、Oh My Zsh、Powerlevel10k 和插件	备份后重写 root 的 `.zshrc`，可修改默认 Shell
5	`mise-setup.sh`	Mise、Python、Node.js 和依赖迁移	配置 Shell 集成及每周 Mise 自动更新
6	`tools-setup.sh`	NextTrace、Speedtest、htop、jq、tree 等	可能添加 NextTrace 第三方 APT 源
7	`docker-setup.sh`	Docker Engine、Compose、Buildx、日志轮转	添加 Docker 官方 APT 源并管理 Docker 服务
8	`auto-update-setup.sh`	定时完整升级系统和内核	更新后需要重启时会等待 30 秒自动重启
9	`ssh-security.sh`	SSH 端口、Root 登录与认证策略	保留当前 `ListenAddress`，完整管理其余主配置；写入前显示 drop-in 冲突并再次确认

当前只有 mise-setup 声明 zsh-setup 为强依赖；其他模块可以单独执行。 SSH 模块要求系统已安装并运行 openssh-server；精简镜像请先执行 sudo apt install -y openssh-server。 Docker 模块会按发行版自动选择 Docker 官方 Debian 或 Ubuntu APT 仓库。菜单编号由主脚本按模块顺序动态生成。模块元数据中的 order=10、20 等值仅用于排序，不是用户需要输入的编号。

配置备份与恢复

模块修改受管配置前会保留两级状态：

*.initial-backup / *.initial-absent
*.previous-backup / *.previous-absent

initial：第一次可信修改前的配置；旧版没有记录且无法证明原始状态时标记为 initial-unknown，不会猜测；
previous：本次运行前的配置，每次运行更新一次；
共享配置（Crontab、.zshrc、.bashrc）按模块分别保存状态，避免不同模块互相覆盖；
APT 软件源备份统一存放在 /var/lib/linux-setup/apt-source-backups/，避免 APT 扫描备份文件时产生无效扩展名提示；
恢复配置不会卸载软件包、内核、容器、Mise 运行时或用户数据。

支持恢复子命令的模块默认恢复 previous；追加 initial 恢复首次可信状态：

sudo bash module.sh restore
sudo bash module.sh restore initial

已经运行旧版脚本的服务器首次执行新版时，会先把当前配置保存为 previous。现有 initial-backup 永不覆盖；无法确认的旧版初始状态会拒绝 restore initial，普通 restore 仍可回到升级新版前的配置。

单独远程运行模块

直接运行模块会绕过主脚本的系统预检查、基础依赖安装、固定 Commit、统一日志和部署摘要。新服务器优先运行主脚本并选择“自定义选择”；仅需重跑或单独配置某项功能时，再直接运行模块。

最小化安装的 Debian/Ubuntu 建议先准备与主脚本相同的基础依赖：

sudo apt update
sudo apt install -y curl wget git jq rsync sudo dnsutils cron psmisc locales gpg gpg-agent dirmngr

以下命令从 main 分支下载并立即执行最新模块。

⚠️ 以下代码块是命令索引。每次只复制并执行需要的模块命令，不要整段执行。 整段执行会依次修改系统、网络、Shell、Docker、自动更新和 SSH 配置，并可能产生大量流量、自动重启或导致失联。

RAW_BASE="https://raw.githubusercontent.com/LucaLin233/Linux/main/modules"

# 1. Zram、系统调优、journald、THP、时区和 Chrony
sudo bash <(curl -fsSL "$RAW_BASE/system-optimize.sh")

# 2. 欢迎信息、中文环境和可选 XanMod
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh")

# 3. 网络优化；默认会自动探测并应用，可能产生大量流量
sudo bash <(curl -fsSL "$RAW_BASE/network-optimize.sh")

# 4. Zsh、Oh My Zsh、Powerlevel10k 和插件
sudo bash <(curl -fsSL "$RAW_BASE/zsh-setup.sh")

# 5. Mise、Python 和 Node.js；请先完成第 4 项
sudo bash <(curl -fsSL "$RAW_BASE/mise-setup.sh")

# 6. NextTrace、Speedtest、htop、jq、tree 等工具
sudo bash <(curl -fsSL "$RAW_BASE/tools-setup.sh")

# 7. Docker Engine、Compose 和 Buildx
sudo bash <(curl -fsSL "$RAW_BASE/docker-setup.sh")

# 8. 每周系统与内核更新；需要时会自动重启
sudo bash <(curl -fsSL "$RAW_BASE/auto-update-setup.sh")

# 9. SSH 安全配置；操作前先确认控制台和云防火墙可用
sudo bash <(curl -fsSL "$RAW_BASE/ssh-security.sh")

system-optimize.sh 的 restore 只恢复该模块管理的配置和关联运行值，不卸载已安装软件：

RAW_BASE="https://raw.githubusercontent.com/LucaLin233/Linux/main/modules"
sudo bash <(curl -fsSL "$RAW_BASE/system-optimize.sh") restore
sudo bash <(curl -fsSL "$RAW_BASE/system-optimize.sh") restore initial

system-customize.sh 支持只运行指定功能：

RAW_BASE="https://raw.githubusercontent.com/LucaLin233/Linux/main/modules"
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh") motd
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh") locale
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh") xanmod
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh") status
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh") restore
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh") restore initial
sudo bash <(curl -fsSL "$RAW_BASE/system-customize.sh") help

restore 会统一恢复 MOTD、Locale 和 XanMod 软件源文件；默认恢复上一次运行前状态， restore initial 恢复首次运行前的可信状态。已安装的 XanMod 内核包不会被卸载。

network-optimize.sh 支持先计算、手动指定参数、查看状态和恢复配置：

RAW_BASE="https://raw.githubusercontent.com/LucaLin233/Linux/main/modules"
# 交互终端无参数运行：选择测速，或拒绝后手填上下行带宽
sudo bash <(curl -fsSL "$RAW_BASE/network-optimize.sh")

# 非交互必须明确指定完整带宽或使用 --probe
bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") \
  plan --download-mbps 1000 --upload-mbps 500

# 明确允许主动探测
sudo bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") install --probe

# 使用明确的带宽和 RTT，避免自动测速
sudo bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") \
  install --download-mbps 1000 --upload-mbps 500 --rtt-ms 180

# 只读性能验证；交互确认后比较 1 流与 4 流
bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") verify

bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") status
sudo bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") restore
sudo bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") restore initial
bash <(curl -fsSL "$RAW_BASE/network-optimize.sh") help

主脚本交互运行到网络模块时只询问是否执行主动测速；选择多个模块也不会跳过该确认。拒绝测速后必须手填下载和上传带宽，RTT 缺省按 150 ms 计算；显式 --rtt-ms 严格使用用户值。无 TTY 时只接受 --probe、--bandwidth-mbps 或完整的 --download-mbps 与 --upload-mbps。主动探测失败时，有 TTY 会转为手填，无 TTY 则在写配置、sysctl 或路由前失败。主动探测只测带宽、不采集 RTT；未显式提供 --rtt-ms 时，BDP 按 150 ms 计算。

initcwnd 默认为 auto：已知上传带宽不高于 100 Mbps 时保留内核默认，否则在默认路由设置 initcwnd/initrwnd=32；--enable-initcwnd 和 --disable-initcwnd 可显式覆盖。status 同时检查 ownership marker 与真实默认路由，并把 marker/路由不一致报告为漂移；也会区分 default qdisc 和默认出口实际 active qdisc，能识别 root fq、mq + 全 fq leaves、htb + 全 fq leaves，以及混合或不可读状态。verify 自动选择附近公共 iperf3 对端和可用端口，只有交互确认或非交互显式 --yes 后才测试；比较 1 流与 4 流 sender/receiver goodput、重传率和 CPU，并报告测试期间 softnet、网卡丢包/错误、全机 TCP 重传及可用的驱动 allowance 增量。全程不修改 sysctl、路由或 qdisc，也不自动安装依赖。

默认不写入 net.ipv4.tcp_ecn；只有显式传入 --disable-ecn 时才持久写入 0。

网络模块默认面向同时承载 TCP、UDP 与 Docker 流量的代理节点：连接队列使用 somaxconn=65535、tcp_max_syn_backlog=16384，TCP 缓冲起点固定为 2 MiB，长流继续依赖 autotuning。动态最大值按 2 × BDP + 2 MiB 计算，并限制为有效 RAM（物理 RAM 与有限 cgroup memory limit 的较小值）的 1/32；RAM cap 最低 8 MiB、最高 256 MiB，动态 socket 最大值另保留 4 MiB 绝对下限。模块启用 TCP receive autotuning、window scaling、SACK、DSACK、时间戳和 syncookies，但保留内核或发行版管理的 tcp_mem、core socket 默认值、netdev_budget 与 netdev_budget_usecs。status 只读显示这些参数，并补充 tcp_tw_reuse、min_free_kbytes、file-max、nr_open 与 file-nr，供出现端口、内存、NAPI 或 file handle 压力时按证据判断，而不是无条件写入固定优化值。

RAW_BASE 只在当前 Shell 会话有效。上述进程替换语法需要 Bash 或 Zsh；不要改成 curl ... | sudo bash，否则交互模块可能无法正常读取终端输入。SSH、自动更新、内核和网络模块具有断连、重启或大量流量风险，执行前请阅读“高风险提醒”。

新增模块

新增脚本只需放入 modules/，无需修改主脚本。文件名必须匹配：

[a-z0-9][a-z0-9-]*.sh

脚本开头声明：

#!/usr/bin/env bash
# linux-setup:name=模块显示名称
# linux-setup:order=100
# linux-setup:depends=
# linux-setup:enabled=true

主脚本会检查 Bash 语法、未知依赖和循环依赖，并按照 order 和文件名生成稳定顺序。退出码约定：0 成功、2 部分完成、其他值失败。

独立工具

tools/ 下的脚本不会被一键部署自动执行，应按需手动运行。

Cloudflare Tunnel

tools/cloudflare_tunnel.sh 是 Cloudflare 官方 APT 安装流程的薄包装器，只支持 Debian/Ubuntu 与 systemd。它使用官方 stable 软件源和 cloudflared service install，不再下载裸二进制。安装完成后会询问是否启用受管的 APT systemd timer，默认不启用；也可稍后使用独立命令启用。

sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/cloudflare_tunnel.sh) install
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/cloudflare_tunnel.sh) upgrade
bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/cloudflare_tunnel.sh) status
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/cloudflare_tunnel.sh) enable-auto-update
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/cloudflare_tunnel.sh) disable-auto-update
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/cloudflare_tunnel.sh) migrate-legacy
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/cloudflare_tunnel.sh) uninstall

安装时 Token 使用隐藏输入，不会写入日志。APT 包会随普通 apt upgrade 或 apt full-upgrade 更新，但这些命令本身不会自动运行。enable-auto-update 会创建每日 systemd timer：先执行 apt-get update，比较已安装版本与候选版本，只在存在新版时升级 cloudflared；服务原本运行时才会重启。timer 使用随机延迟、APT 锁等待和独立 flock，日志进入 journal。

启用自动更新意味着升级时单实例 Tunnel 会短暂中断。如果已经使用本仓库 auto-update-setup.sh 每周执行完整系统升级，通常无需重复启用此 timer；只有需要更频繁检测 cloudflared 时再启用。upgrade 可用于立即手动检查、升级并重启服务。

旧版脚本用户无需先卸载，可直接重新运行 install。确认旧二进制、unit 路径和版本均匹配旧版受管安装后，脚本会全自动安装 APT 包，把 cloudflared.service 从 /usr/local/bin/cloudflared 事务式迁移到 /usr/bin/cloudflared，原样保留 Token/config 参数，验证服务后再备份并移除旧二进制，无需重新输入 Token。任一验证失败都会恢复旧 unit 和运行状态；归属证据不足则保留文件并停止，不盲删。若上一次迁移已完成 APT 安装和 unit 切换，只留下 /usr/local/bin/cloudflared -> /usr/bin/cloudflared 兼容链接，重新运行也会自动识别、备份并收尾。 migrate-legacy 可单独执行相同迁移流程。

脚本使用 service install --no-update-service，并识别、备份和清理旧版裸二进制更新单元，避免 APT 包与 cloudflared update 混用。若旧环境已有每日自动更新 timer，迁移时会自动换成新的 APT timer；旧环境未启用自动更新时仍保持关闭并询问是否启用。uninstall 删除服务、APT 包及本脚本管理的软件源，但保留 Tunnel 配置和凭据。彻底清理须显式运行 purge，并在交互终端输入 PURGE 二次确认。

出口流量整形 tcshape

基于 tcpfit v0.5.6 选择性移植限速器拐点 Sweep 与 HTB + fq Shape。它不会修改基础 sysctl，适用于存在出口 policer 的特定 VPS，不是通用必选优化。

首次运行：

curl -fsSLo /tmp/tcshape.sh https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/traffic-shape.sh && sudo bash /tmp/tcshape.sh

该写法先落盘再执行，兼容 Termius，也避免部分 Bash 进程替换场景中的 /dev/fd/* 无法二次读取。新版仍会识别 bash <(curl ...)：若启动源不可复制，会从官方仓库重新下载并校验后安装；检测到旧版遗留的零字节 /usr/local/sbin/tcshape 时会自动安全替换，非空且无受管标记的文件仍拒绝覆盖。

随后可使用短命令：

sudo tcshape s        # 自动选公共节点并扫描
sudo tcshape a        # 应用 24 小时内的最近推荐值
sudo tcshape on 480   # 手动限制为 480 Mbit
sudo tcshape off      # 关闭并恢复原 qdisc
sudo tcshape st       # 只读查看状态，不自安装或安装依赖
sudo tcshape u        # 从 LucaLin233/Linux main 检查更新
sudo tcshape apply --force  # 明确强制使用超过 24 小时的旧推荐值

tcshape 明确支持 Debian 12+ 与 Ubuntu 22.04+，要求 root、systemd、APT 及内核允许管理 qdisc。Ubuntu 软件源缺少 iperf3 时会提示先启用 universe，不会继续半安装。

Sweep 可能消耗大量上传流量，并会临时替换默认出口接口的根 qdisc。单方向上限约 45 GB，双向合计上限约 90 GB。未检测到限速器或未找到拐点时，不建议且不能自动应用整形。 tcshape a 默认只接受 24 小时内的成功结果；相同推荐值已完整启用时直接返回，不重建 qdisc。超过 24 小时的结果应重新扫描，仅在明确确认线路未变化时使用 tcshape apply --force。自动扫描上限默认 10 Gbit，可用 tcshape scan --cap N 明确调整；可用 --loss-threshold PCT 覆盖默认 0.1% 重传率阈值。跨出口接口重新设置时会验证新整形后清理旧接口 HTB 并迁移恢复基线，失败则回滚；带自定义参数的 fq/fq_codel 会被拒绝接管。不限速单流低于自动选点或 --nominal 参考带宽的 70% 时，会按 tcpfit v0.5.6 在同一节点补测两次，并按接收带宽选取最高的完整样本。重传率优先使用 iperf3 实际字节数与 MSS 计算。

tcshape u/tcshape update 会读取 LucaLin233/Linux 的 main 最新提交，按固定 Commit 下载并校验受管标记、版本号和 Bash 语法，再原子替换短命令。上一版本保存在 /usr/local/sbin/tcshape.previous；配置、Sweep 结果和当前 qdisc 不会被修改。已安装 1.0.3 或更早版本的机器需要先按上面的“首次运行”命令升级一次，之后才能使用更新短命令。

详细参数、安全边界和恢复说明见 docs/traffic-shape.md。

多服务器文件推送

tools/push.sh 使用 SSH 和 rsync 并发同步文件，支持密钥或密码认证。

该工具依赖本地 config.conf 和待推送文件，不适合远程即用方式，请克隆仓库后运行：

git clone https://github.com/LucaLin233/Linux.git
cd Linux
./tools/push.sh --generate-config
./tools/push.sh --test-auth
./tools/push.sh TASK_NAME
./tools/push.sh /local/path/ /remote/path/

默认生成当前目录的 config.conf，权限为 600，且仓库已通过 .gitignore 忽略根目录和 tools/ 下的该文件。该文件会作为受信任的 Bash 配置加载，因此拒绝符号链接、非当前用户/root 所有以及组或其他用户可写的配置。默认使用密钥认证、持久化 known_hosts，并支持 user@[IPv6]:port 格式。

示例配置默认 DELETE_EXTRA="false"，不会删除目标端多余文件。启用删除时，交互执行必须输入 DELETE；非交互执行还须显式设置 ALLOW_DELETE_EXTRA="true"。将 known_hosts 指向 /dev/null 同样需要显式设置 ALLOW_INSECURE_HOST_KEY_STORAGE="true"，不推荐这样做。

sing-box 安装

sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/sbinstall.sh) install
bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/sbinstall.sh) status
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/sbinstall.sh) uninstall

安装前需准备有效的 /root/proxy/config.json；证书由该配置引用时还需准备 cert.crt 和 private.key。脚本从 SagerNet GitHub Release API 获取目标文件及 SHA-256 digest，在 staging 目录完成摘要、版本和 sing-box check 校验后才替换运行版本。已有二进制和 unit 会保存到 /root/proxy/backup；替换或服务重启失败时自动回滚。卸载仅移除本脚本可确认管理的服务和程序文件，保留配置、证书与回滚快照。

独立动态 MOTD

sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/setup-motd.sh) install
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/setup-motd.sh) status
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/setup-motd.sh) restore
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/setup-motd.sh) restore initial

用于只部署动态登录欢迎信息，与 modules/system-customize.sh 使用相同 MOTD 模板和 previous/initial 两级备份状态。已经运行系统定制模块时通常无需重复安装。静态欢迎文件会备份后替换为空的普通文件，避免 PAM 重复显示；动态脚本备份保存在 /var/lib/linux-setup/motd-backups。状态面板直接显示 load average，不再为计算即时 CPU 百分比而固定延迟每次登录。

XanMod 内核

sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/xanmod-install.sh)
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/xanmod-install.sh) status
sudo bash <(curl -fsSL https://raw.githubusercontent.com/LucaLin233/Linux/main/tools/xanmod-install.sh) help

脚本检测 x86-64 psABI 级别并选择适合的 XanMod 包。内核安装完成后通常需要重启才能生效；请保留可用旧内核和控制台访问方式。

配置文件

p10k-config.zsh：供 Zsh 模块使用的 Powerlevel10k 配置；
config.conf：push.sh 生成的本地配置，可能包含敏感信息，不应提交；
THIRD_PARTY_NOTICES.md：第三方代码来源和许可证。

功能重叠与选择

需求	推荐脚本	避免同时使用
新 Debian/Ubuntu VPS 网络基础调优	`modules/network-optimize.sh`	其他会覆盖 sysctl 或根 qdisc 的调优脚本
特定出口 policer 检测与整形	`tools/traffic-shape.sh`	tcpfit Shape、CAKE、TBF、其他 HTB
一键系统定制	`system-customize.sh`	重复运行 `setup-motd.sh`
仅安装 XanMod	`xanmod-install.sh`	同时让多个脚本反复管理内核源

network-optimize.sh 与 traffic-shape.sh 职责不同，可以配合：前者管理 BBR、缓冲区、默认 fq 和按内核能力启用的 TCP 参数。IPv4/IPv6 forwarding 与 RA 管理不是 tcpfit 移植内容，而是为当前 Docker/VPS 环境保留的下游扩展：all/default 保留 accept_ra=1，实际 IPv6 默认出口使用 accept_ra=2，现有 Docker、veth、CNI 与隧道接口的 RA 在运行时设为 0 并纳入回滚快照。后者在确实检测到 policer 后才使用 HTB 控制聚合出口速率，并保留 fq 叶子 pacing。

高风险提醒

SSH：修改端口或认证前，先放行云安全组/防火墙，并保持当前会话直到新连接验证成功；
自动更新：系统或内核更新后可能自动重启；
系统优化：首次写入 journald 限额时会重启 systemd-journald，并设置 Kernel Panic 30 秒后重启；
IPv6 转发：网络模块会使用 accept_ra=2 保留云平台 RA，但仍需确认云安全组和主机防火墙允许预期的 IPv6 流量；
网络测速：network-optimize 和 tcshape 都可能产生大量流量；
qdisc：不要叠加多个整形工具；tcshape 遇到高级或未知 qdisc 会拒绝覆盖；
内核：安装新内核前确认磁盘空间、架构和可用的旧内核；
rsync：默认不删除远端文件；显式启用 DELETE_EXTRA=true 后会要求额外确认；
凭据：不要提交 Token、密码、私钥、.env 或 config.conf。

问题排查

先收集完整、脱敏的信息：

cat /etc/os-release
uname -a
sudo tail -n 200 /var/log/linux-setup.log
systemctl --failed
journalctl -p warning -b --no-pager

根据故障再检查对应服务：

systemctl status ssh docker chrony cron tcshape.service
sshd -t
tc qdisc show
sysctl net.ipv4.tcp_congestion_control net.core.default_qdisc

提交 Issue 时请提供系统版本、执行命令、退出码和已脱敏的完整日志，不要包含 Token、密码、私钥、服务器清单或公网管理地址。

许可证与免责声明

本仓库采用 MIT License。第三方移植代码见 THIRD_PARTY_NOTICES.md。

脚本按“原样”提供，不附带任何担保。发行版、内核、虚拟化、机房网络和软件源存在差异，使用者应自行审查、备份、验证并承担操作后果。

Navigation Menu

Repository files navigation

Linux Scripts Collection

支持范围

快速开始

Linux 一键部署

部署模块

配置备份与恢复

单独远程运行模块

新增模块

独立工具

Cloudflare Tunnel

出口流量整形 tcshape

多服务器文件推送

sing-box 安装

独立动态 MOTD

XanMod 内核

配置文件

功能重叠与选择

高风险提醒

问题排查

许可证与免责声明

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
docs		docs
modules		modules
tests		tests
tools		tools
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
THIRD_PARTY_NOTICES.md		THIRD_PARTY_NOTICES.md
linux_setup.sh		linux_setup.sh
p10k-config.zsh		p10k-config.zsh

Latest commit

History

Folders and files

Repository files navigation

Linux Scripts Collection

支持范围

快速开始

Linux 一键部署

部署模块

配置备份与恢复

单独远程运行模块

新增模块

独立工具

Cloudflare Tunnel

出口流量整形 tcshape

多服务器文件推送

sing-box 安装

独立动态 MOTD

XanMod 内核

配置文件

功能重叠与选择

高风险提醒

问题排查

许可证与免责声明

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages