SrP-BloG

SrP-CFG 游戏设置预设文件 | CS2

Sat, 12 Apr 2025 00:00:00 GMT

简介

Bilibili视频链接：BV1n7C2BzE11

在这篇文章中将一步步地帮助你完成：

找到 CFG 存储位置，定制个性化功能，编写 CFG 文件，并成功应用；
在必要时刻还原 CFG，避免操作不当产生的后果；
根据文件实时查看所更改设置的指令，辅助编写 CFG 文件；
在本人提供的预设 CFG 基础上，使用或魔改；
向本人联系，为你的预设添加进仓库，得到同步更新。

CFG 简介

CFG 是 config(设置)的简写，能够以代码写入文件中，来保存游戏设置，在多账号和多设备登录情况下非常好用。

另外，一些特殊的指令，只有使用CFG才能在游戏中快速使用。

CFG 存放位置

首先，Steam云是 Valve 帮助单机玩家保存存档备份的一项功能，但它也同样被运用到了CS2中。

由于国内裸连 Steam 甚至打不开商店和社区，所以Steam云的效果可想而知，特别是CS2在多次启动的情况下，会不断调用Steam云，如果某一时刻网络不佳，就会导致同步失败，进而影响游戏设置。

为了避免这种混乱，建议使用本地存档的位置来保存CFG，并禁用CS2的Steam云功能。

根据以上说明，那么CFG就会有两个位置：

游戏全局CFG(上文中的本地存档)：...\SteamLibrary\steamapps\common\Counter-Strike Global Offensive\game\csgo\cfg** 或 **...\Steam\steamapps\common\Counter-Strike Global Offensive\game\csgo\cfg
个人用户CFG(上文中Steam云保存的位置)：...\Steam\userdata\123456789\730\local\cfg

需要注意的是：

根据游戏安装位置的不同，游戏全局CFG可能是在两种位置中的一种，
- 根据Steam本体和游戏安装位置是否相同确认，如果你的游戏存放盘符与 steam 存放盘符不同，就参考前者，若相同，则后者。
- 建议将要用的CFG文件放在游戏全局CFG位置。
个人用户CFG位置中的123456789为 steamID(同时也是文件夹名称)，可用于添加好友，如果你的 PC 上有多个 steam 账号登录过，那么在 userdata 文件夹中你会看到多个用户文件夹。
- 请前往Steam->好友->添加好友处查看当前账号的steamID
- 与游戏全局CFG 不同，个人用户CFG不止能设置CFG文件，还多了一个 cs2_video.txt 配置文件,它能够对游戏的画面设置进行设置，后文会提到。
- cs2_video.txt的位置：...\Steam\userdata\123456789\730\local\cfg\cs2_video.txt

下面是使用Steam应用可视化查找游戏全局CFG位置的操作流程：

打开 steam 库，找到 Counter-Strike 2，右击选择属性

选择“已安装文件”，点击浏览

进入“game”，进入“csgo”，选择“cfg”，该目录下就是存放 cfg 文件的位置

一个特殊的 CFG 模板

Steam启动项是 steam 在启动游戏时自动为游戏执行的命令，位置依旧是在前文提到的游戏属性中。 exec指令可以理解为加载的意思，例如exec auto.cfg就是加载auto.cfg这个文件，这样CFG的功能才能被启用。

在众多CFG文件中，有一个名为autoexec.cfg的文件是极其特殊的，无论你是否在Steam启动项中添加了exec指令，它都会被游戏启动时自动加载，因此它非常适合放一些基础功能。

这里给出autoexec.cfg的文件模板：

//键位
bind "w" "+forward" //前进
bind "s" "+back" //后退
bind "a" "+left" //向左
bind "d" "+right" //向右
bind "mouse1" "+attack" //左键攻击
bind "mouse2" "+attack2" //右键特殊攻击
bind "e" "+use" //使用
bind "f" "+lookatweapon" //检视
bind "space" "+jump"  //跳跃
bind "ctrl" "+duck"  //蹲下
bind "tab" "+showscores" //打开计分板
bind "g" "drop"   //丢弃装备
bind "m" "teammenu" //选择队伍
bind "shift" "+sprint" //静步
bind "b" "buymenu" //购买菜单
bind "z" "slot6" //雷
bind "x" "slot7" //闪
bind "c" "slot8" //烟
bind "6" "slot9" //诱饵弹
bind "v" "slot10" //火
bind "y" "+spray_menu" //打开涂鸦菜单
bind "i" "messagemode2"//团队聊天框
bind "u" "messagemode"//全局聊天框
bind "mouse4" "+voicerecord"//打开麦克风
bind "mouse5" "player_ping"//玩家示意标志
bind "mwheeldown" "+jump" //滚轮下跳
bind "mwheelup" "+jump"//滚轮上跳
bind "`" "toggleconsole"//打开控制台
bind "t" "switchhands"//切换左右手持枪
bind "h" "toggleradarscale" //切换小地图缩放
bind "ralt" "radio2;slot12" //无线电与X光

//准星
cl_crosshair_drawoutline "0" // 禁用十字准星的轮廓线
cl_crosshair_dynamic_maxdist_splitratio "1" // 动态十字准星的最大分离距离比例
cl_crosshair_dynamic_splitalpha_innermod "0" // 动态十字准星内部分离部分的透明度
cl_crosshair_dynamic_splitalpha_outermod "1" // 动态十字准星外部分离部分的透明度
cl_crosshair_dynamic_splitdist "3" // 动态十字准星的分离距离
cl_crosshair_friendly_warning "0" // 禁用对友军的十字准星警告
cl_crosshair_outlinethickness "1" // 十字准星轮廓线的厚度
cl_crosshair_sniper_show_normal_inaccuracy "0" // 禁用狙击枪十字准星显示正常不准确度
cl_crosshair_t "0" // 禁用T形十字准星
cl_crosshairalpha "255" // 十字准星的透明度（255为完全不透明）
cl_crosshaircolor 5 // 设置十字准星颜色为自定义（5表示自定义颜色）
cl_crosshaircolor_b "255" // 自定义十字准星的蓝色分量（255为最大）
cl_crosshaircolor_g "255" // 自定义十字准星的绿色分量（255为最大）
cl_crosshaircolor_r "0" // 自定义十字准星的红色分量（0为最小）
cl_crosshairdot "0" // 禁用十字准星中心点
cl_crosshairgap "-3.644676" // 设置十字准星的间隙（负值表示向内收缩）
cl_crosshairgap_useweaponvalue "0" // 禁用根据武器值调整十字准星间隙
cl_crosshairsize "0.901125" // 设置十字准星的大小
cl_crosshairstyle "4" // 设置十字准星样式为经典静态（4表示经典静态）
cl_crosshairthickness "0.961664" // 设置十字准星的厚度
cl_crosshairusealpha "1" // 启用十字准星的透明度设置

//狙击枪瞄准线宽度
cl_crosshair_sniper_width "2"

//鼠标灵敏度
sensitivity 0.50

//持枪视角
viewmodel_fov 68 // 设置第一人称视角的视野范围（FOV），值越大，视野越广
Viewmodel_offset_x 2.5 // 调整武器模型在水平方向（X轴）上的偏移，正值向右，负值向左
Viewmodel_offset_y 0 // 调整武器模型在垂直方向（Y轴）上的偏移，正值向上，负值向下
Viewmodel_offset_z -1.5 // 调整武器模型在深度方向（Z轴）上的偏移，正值向前，负值向后
viewmodel_presetpos 2 // 使用预设的武器模型位置（2表示经典位置）

//雷达
cl_radar_always_centered "0" // 禁用雷达始终以玩家为中心，雷达会显示地图的完整区域
cl_radar_scale "0.37" // 设置雷达的缩放比例，值越小，雷达显示的范围越大
cl_hud_radar_scale "1" // 设置HUD上雷达的缩放比例，1为默认大小
cl_teammate_colors_show 2 // 设置队友颜色显示模式，2表示显示队友的轮廓颜色

如何创建一个`CFG`文件

在接触CFG文件之前，我们似乎很少见到后缀为.cfg的文件，它是一种专为配置文件所产生的格式。

我们可以通过新建.txt文本格式文件，更改其后缀名为.cfg得到CFG文件：

在桌面新建一个文本文档(也就是 txt)，可以直接在这个 txt 文件中编写配置(当然.cfg文件也可以用记事本打开并编辑)

编写完成后，找到这个文件，更改后缀为 .cfg。
- 如果你无法显示后缀，请按照下面操作：

视频设置文件

虽然视频设置文件是以.txt格式保存的，但它也是一种Config也即CFG。

下面是一个cs2_video.txt文件的模板，需要注意的是：

所有的注释要删除掉，文件功能才能被正常启用。
该文件要放入个人用户CFG目录下：...\Steam\userdata\123456789\730\local\cfg

"video.cfg"
{
	"Version"		"16"  // 配置文件版本号
	"VendorID"		"4318"  // 显卡厂商识别码，此处为NVIDIA
	"DeviceID"		"10464"  // 显卡设备识别码，此处为RTX 4060
	"setting.cpu_level"		"3" // CPU 性能等级梯队
	"setting.gpu_mem_level"		"3" // GPU 显存性能等级梯队
	"setting.gpu_level"		"3" // GPU 性能等级梯队
	"setting.knowndevice"		"0" // 优先使用的GPU设备（0 为主显卡）
	"setting.monitor_index"		"0" // 显示器索引（0 为主显示器）
	"setting.defaultres"		"1280" // 分辨率宽度
	"setting.defaultresheight"		"960" // 分辨率高度
	"setting.aspectratiomode"		"0" // 宽高比模式（0 为自动，1 为 4:3，2 为 16:9）
	"setting.refreshrate_numerator"		"0" // 刷新率分子（0 表示使用默认值）
	"setting.refreshrate_denominator"		"0" // 刷新率分母（0 表示使用默认值）
	"setting.fullscreen"		"0" // 是否启用全屏模式（0 为否，1 为是）
	"setting.coop_fullscreen"		"1" // 合作模式是否启用全屏（1 为是）
	"setting.nowindowborder"		"1" // 是否启用无边框窗口模式（1 为是）
	"setting.fullscreen_min_on_focus_loss"		"0" // 失去焦点时是否最小化全屏窗口（0 为否）
	"setting.high_dpi"		"0" // 是否启用高 DPI 缩放（0 为否）
	"setting.mat_vsync"		"0" // V-sync 是否启用垂直同步（0 为否，1 为是）
	"setting.r_low_latency"		"0" // 是否启用低延迟模式（1 为是）
	"AutoConfig"		"2" // 自动配置等级（2 为自定义配置）
	"setting.msaa_samples"		"2" // 多重采样抗锯齿（MSAA）采样数（2 为 2x MSAA）
	"setting.r_csgo_cmaa_enable"		"1" // 是否启用 CMAA 抗锯齿（0 为否）
	"setting.videocfg_shadow_quality"		"3" // 全局阴影效果（0 为低，1 为中，2 为高，3 为非常高）
	"setting.videocfg_dynamic_shadows"		"1" // 动态阴影的启用（1 为是）
	"setting.videocfg_texture_detail"		"1" // 模型/贴图细节（0 为低，1 为中，2 为高）
	"setting.r_texturefilteringquality"		"3" // 贴图过滤模式（0-5，双线性、三线性、异项2X、4X、8X、16X）
	"setting.shaderquality"		"0" // 光影细节（0 为低，1 为高）
	"setting.videocfg_particle_detail"		"0" // 粒子细节（0 为低，1 为中，2 为高，3 为非常高）
	"setting.videocfg_ao_detail"		"0" // 环境光遮蔽（AO）细节（0 为禁用，2 为中，3 为高）
	"setting.videocfg_hdr_detail"		"3" // 高动态范围 （-1为品质，3为性能）
	"setting.videocfg_fsr_detail"		"0" // 超级分辨率FSR（0 为禁用，1、2、3、4分别为超高品质、品质、均衡、性能）
}

还原与备份

进入CS2游戏，在设置中将启用控制台选择为是，默认情况下可以按 `来打开控制台如果不行，请切换为英文输入法或者点击按键CAPS来切换锁定大小写，直到 ` 被游戏正确读取并打开控制台

如果你使用了网络上的CFG预设后按键不知道怎么恢复？或者应该如何试用他人的CFG预设？

让我们先进入游戏，打开控制台来解决这两个问题：

输入 host_writeconfig backup 可生成 backup.cfg
- 这是你当前按键绑定的一个备份，需要在试用他人的CFG预设前操作，可在必要时在控制台输入 exec backup 恢复原按键绑定设置
输入 binddefaults后，将按键绑定改为默认按键。
- 此时输入key_listboundkeys 可在控制台输出里查看所有的按键绑定功能

一些有趣的控制台指令

在Vavle 开发者社区的 CS2 板块找到所有控制台指令也可以在游戏中输入cvar list，控制台则会输出全部的指令。

了解控制台指令功能，可以将其绑定在按键上，并写入 CFG 文件，实现一键功能。

sv_cheats 1 // 开启作弊模式，允许使用作弊命令
bot_kick // 踢出所有机器人
mp_buy_anywhere 1 // 允许在任意位置购买装备
mp_freezetime 0 // 设置赛前准备时间为0秒
mp_maxmoney 99999 // 设置最大金钱数为99999
mp_startmoney 99999 // 设置起始金钱数为99999
mp_buytime 99999 // 设置购买时间为99999秒
mp_ignore_round_win_conditions 1 // 回合永不结束
mp_respawn_on_death_ct 1 // CT阵营无限复活
mp_respawn_on_death_t 1 // T阵营无限复活
mp_friendlyfire 1 // 开启队友伤害
ammo_grenade_limit_total 6 // 设置手榴弹最大可携带数为6
mp_spectators_max 9 // 设置游戏观察者最大数为9
mp_autokick 0 // 禁用自动踢出服务器功能
mp_restartgame 1 // 在1秒后重启回合
sv_grenade_trajectory_prac_pipreview 1 // 启用手榴弹轨迹的预览
sv_grenade_trajectory_prac_trailtime 8 // 设置手榴弹轨迹可见时间为8秒
sv_infinite_ammo 2 // 设置无限弹药模式（道具无限），但仍需换弹夹
sv_showimpacts 1 // 开启弹痕显示
exec autoexec.cfg // 执行 autoexec.cfg 配置文件，加载自定义设置
key_listboundkeys // 列出所有已绑定的按键及其对应的命令
toggle cl_teamid_overhead_mode 1 3 // 切换队友头顶标识模式（1 为简单标识，3 为详细标识）
toggle cl_draw_only_deathnotices 1 0 // 切换是否仅显示死亡通知（1 为仅显示，0 为显示完整 HUD）
toggle cl_drawhud_force_radar 1 0 // 切换是否强制显示雷达（1 为强制显示，0 为正常显示）
cl_hud_color "11" // 设置 HUD 颜色为粉色
con_enable "1" // 启用控制台功能
fps_max 0 // 设置 FPS 无上限，允许游戏以最高帧率运行
cl_join_advertise "2" // 显示玩家计划加入反恐精英队的信息
cl_use_opens_buy_menu "0" // 禁用在靠近购买区域时按下使用键（E键）自动打开购买菜单的功能
cl_dm_buyrandomweapons 0 // 在死亡竞技模式中禁用自动购买随机武器
gameinstructor_enable "0" // 禁用游戏指导功能
cl_autohelp "false" // 禁用自动帮助提示
mm_dedicated_search_maxping "70" // 优先选择延迟在 70 毫秒以内的服务器
func_break_max_pieces 0 // 游戏会根据物体的属性生成默认数量的碎片
r_drawtracers_firstperson 1 // 开启第一人称视角中的子弹轨迹显示
r_fullscreen_gamma 3.0 // 调整游戏画面伽马值为 3.0
cl_teamid_overhead_mode 3 // 始终显示队友名称与装备信息
echo AutoConfig Enabled! // 在控制台打印 "AutoConfig Enabled!" 提示信息
mp_damage_headshot_only 1 // 仅爆头才能造成伤害，其他部位攻击无效
ent_create chicken // 在游戏中生成一只鸡（娱乐功能）
custom_bot_difficulty 5 // 设置自定义 BOT 难度为最高（5 为最高难度）
mp_plant_c4_anywhere 1 // 允许在任何位置安放 C4 炸弹
mp_c4timer 40 // 设置 C4 炸弹的倒计时为 40 秒
sv_regeneration_force_on 1 // 开启生命值自动回复功能
cl_showpos 1 // 在屏幕上显示玩家当前的位置、速度和角度信息
mp_weapons_glow_on_ground 1 // 开启地面武器的高亮显示功能

如何即时查看`CFG`的命令参数

我们知道既然游戏设置可以被CFG文件所设置，那么这些游戏设置项的参数也一定是被记录在了文件中，在这里我们就是要找到这样的参数，来辅助编写CFG文件。

场景一：使用CFG文件来配置准星

CS2提供的方式是使用准星代码导入导出来实现准星更改，但这样我们还是不知道哪条指令的哪个参数改变了该准星的样貌，并且CFG文件也并不能根据准星代码来设置准星；

如果你详细查看了前文的autoexec.cfg文件内容，不难发现我们是用cl_crosshair_.. "0"类似的指令来更改准星的，那么这些指令和参数在哪里找到？

场景二：目标功能为按下C键切换为烟雾弹，但是不知道什么指令是切换为烟雾弹，在哪里找？

虽然这一小节解决问题的方法是即时查看所更改的设置，但是场景二可以在CS2BindGenerator网站上自动生成对应指令。

场景三：游戏中有一个快捷轮盘功能，我想要自定义设置它每一个语音指令的位置，并且保存下来，它们的指令是什么？

针对以上三种场景，我们可以打开即时保存设置的文件来查看当我们在游戏中进行操作后，对应文件会有什么样的信息，来确定某项功能的对应指令：

找到如下路径 ...\Steam\userdata\123456789\730\local\cfg ,找到如下文件打开。

这里的参数就是准星参数，在导入准星代码后，重新打开或刷新该文件，此部分参数就会更改，届时保存即可。

下面这个文件里就是所有的按键绑定即时操作，可以查看所有刚刚更改的按键绑定。

下面这个文件为快捷轮盘chatwheel的各语音关键词代码：

设置启动项

启动项是在游戏运行时即刻执行的命令，严格来说这也是一种Config配置

下面使一些常用启动项，需要注意的是：

每一条指令之间要有一个空格来分割。

-novid  //关闭过场动画,CS2中已失效
-high  //提高CSGO程序优先级，有可能负优化
-nojoy //关闭手柄相关，降低内存占用
-perfectworld  //直接进入国服
-worldwide  //直接进入国际服
-w 1920 -h 1080  //设置分辨率1920x1080
-noborder //无边框窗口化
+exec auto.cfg  //加载auto.cfg
+fps_max 300  //限制fps最大300
-allow_third_party_software  //允许OBS等第三方软件
-noreflex //取消游戏内的reflex功能，可以在NVIDIA控制面板中开启

下面是本人的启动项：

-allow_third_party_software -worldwide

启动项设置位置已在前文提出，下面是位置图例：

SrP-CFG_ForCS2

本人的CFG预设文件已经在GitHub仓库SrP-CFG_ForCS2中发布

这是本人所使用的一套CFG预设文件，包含了多个场景的CFG使用需求，另外还开发了该套CFG的官方网站和一键安装程序，且长期维护更新，保证有效可用。

::github{repo="RolinShmily/SrP-CFG_ForCS2"}

你会需要的链接：

下面是一些SrP-CFG-Installer-V3版本的一些程序页面：

在Windows上使用MSYS2+MinGW工具链 | gcc | gdb | cmake | make | Ninja | VScode

Sun, 10 May 2026 00:00:00 GMT

MSYS2+VScode安装与配置

前往MSYS2官方文档和VScode官网下载安装包，并进行安装(推荐安装路径均为默认)。

VScode常用插件(拓展)与设置

建议登录一个Microsoft微软或GitHub账户，用于开启同步设置，并在默认配置文件或新建配置文件中进行常用设置，后面根据语言可以新建配置文件复制通用配置，再安装对应的拓展，进行拓展分离。

VScode设置(settings.json)文件内容：

{
  // 自动保存文件
  "files.autoSave": "afterDelay",
  // 自动猜测文件编码
  "files.autoGuessEncoding": true,
  // 列表、光标移动、编辑器、光标闪烁样式平滑
  "workbench.list.smoothScrolling": true,
  "editor.cursorSmoothCaretAnimation": "on",
  "editor.smoothScrolling": true,
  "editor.cursorBlinking": "smooth",
  // 按住 Ctrl 滚轮缩放编辑器字体
  "editor.mouseWheelZoom": true,
  // 粘贴、输入、保存时自动格式化
  "editor.formatOnPaste": true,
  "editor.formatOnType": true,
  "editor.formatOnSave": true,
  // 自动换行(避免横向滚动条)
  "editor.wordWrap": "on",
  // 括号配对引导线
  "editor.guides.bracketPairs": true,
  // 允许代码片段触发快速建议
  "editor.suggest.snippetsPreventQuickSuggestions": false,
  // 回车键智能接受建议（仅当没有其他文本建议时）
  "editor.acceptSuggestionOnEnter": "smart",
  // 建议列表优先显示最近使用的项
  "editor.suggestSelection": "recentlyUsed",
  // 使用自定义对话框样式
  "window.dialogStyle": "custom",
  // 在概览标尺中显示断点
  "debug.showBreakpointsInOverviewRuler": true,
}

打开VScode设置(Ctrl+,)后，点击打开json文件，即可粘贴设置；下面是一些常用拓展：

Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code：简中语言包。
Hex Editor：16进制文件查看编辑器。
Error Lens：报错高亮。
GBK to UTF8 for vscode：编码格式快速转换。
Doxygen Documentation Generator：注释生成器。
Hungry Delete：快速删除空行、缩进。
Image preview：图片预览器。
Material Icon Theme：文件Icon主题美化。
One Dark Pro：VScode编辑器主题美化。
Path Intellisense：路径补全。
Prettier - Code formatter：代码格式自动优化。
Remote - SSH：SSH链接远程项目地址，似本地一般的编辑体验。
WakaTime：代码编辑时间统计，需要登录。

MSYS2集成终端

在MSYS2文档中，提供了将MSYS2终端集成到VScode的方法，便是在settings.json文件中添加如下字段：

// 注意最外层大括号已在settings.json中存在
// 注意该配置的路径为默认安装路径
{
    "terminal.integrated.profiles.windows": {
        "MSYS2 UCRT": {
            "path": "cmd.exe",
            "args": [
                "/c",
                "C:\\msys64\\msys2_shell.cmd -defterm -here -no-start -ucrt64"
            ]
        }
    }
}

随后便可在VScode中打开MSYS2终端, 除此之外也可以在Windows搜索中输入ucrt打开终端：

C/C++环境配置

打开MSYS2的UCRT64终端，输入如下命令安装工具链：

# 编译器、调试器、构建系统、构建工具
pacman -S mingw-w64-ucrt-x86_64-{gcc,gdb,cmake,ninja,make}
# 版本检查
gcc -v
gdb -v
cmake --version
ninja --version
mingw32-make --version

打开VSCODE，创建配置文件，复制继承上文中的通用配置，随后激活后，在拓展中安装：

由于上文已经安装了MinGW工具链，因此拓展会自动寻找环境变量中的gcc编译器，MSYS2安装在默认位置下便无需手动配置路径了。

Stm32环境配置

安装Stm32CubeMX用于下载固件库和创建工程。

打开MSYS2的UCRT64终端，输入如下命令安装工具链：

# 交叉编译器
pacman -S mingw-w64-ucrt-x86_64-arm-none-eabi-gcc
# 版本检查
arm-none-eabi-gcc --version

打开VSCODE，创建配置文件，复制继承上文中的通用配置，随后激活后，在拓展中安装：

STM32CubeIDE-for-Visual-Studio-Code

同样的，我们已在前文中配置好了gcc、cmake等工具链，拓展在安装完必要的组件后，会自行查找所需工具路径，现在点击左侧小蝴蝶，就能用上Stm32CubeIDE的功能了。

ClaudeCode安装与使用 | Agent | CC-Switch

Sat, 09 May 2026 00:00:00 GMT

Windows终端

按win+x组合键，点击终端会打开Windows PowerShell终端，但这是早期的version5版本，我们需要在微软应用商店里下载version7版本，应用名称为PowerShell。

随后呼出终端，右键顶部选择设置，将默认终端选择为PowerShell，输入如下命令检查版本：

# 检查PowerShell版本
$PSVersionTable.PSVersion

Node环境

前往Node.js官网安装，此步会同步安装npm包管理器和npx快捷运行工具。

随后呼出终端，输入如下命令：

# 允许PowerShell运行本地脚本
Set-ExecutionPolicy RemoteSigned

# 检查node、npm是否安装成功
node -v
npm -v
npx -v

ClaudeCode安装

在官方文档中，推荐的原生安装命令为：

irm https://claude.ai/install.ps1 | iex

但由于国内网络问题，通常是无法持续正常访问的，因此我对脚本进行了解耦：

param(
    [Parameter(Position=0)]
    [ValidatePattern('^(stable|latest|\d+\.\d+\.\d+(-[^\s]+)?)$')]
    [string]$Target = "latest"
)

Set-StrictMode -Version Latest
$ErrorActionPreference = "Stop"
$ProgressPreference = 'SilentlyContinue'

# Check for 32-bit Windows
if (-not [Environment]::Is64BitProcess) {
    Write-Error "Claude Code does not support 32-bit Windows. Please use a 64-bit version of Windows."
    exit 1
}

$DOWNLOAD_BASE_URL = "https://downloads.claude.ai/claude-code-releases"
$DOWNLOAD_DIR = "$env:USERPROFILE\.claude\downloads"

# Use native ARM64 binary on ARM64 Windows, x64 otherwise
if ($env:PROCESSOR_ARCHITECTURE -eq "ARM64") {
    $platform = "win32-arm64"
} else {
    $platform = "win32-x64"
}
New-Item -ItemType Directory -Force -Path $DOWNLOAD_DIR | Out-Null

# Always download latest version (which has the most up-to-date installer)
try {
    $version = Invoke-RestMethod -Uri "$DOWNLOAD_BASE_URL/latest" -ErrorAction Stop
}
catch {
    Write-Error "Failed to get latest version: $_"
    exit 1
}

try {
    $manifest = Invoke-RestMethod -Uri "$DOWNLOAD_BASE_URL/$version/manifest.json" -ErrorAction Stop
    $checksum = $manifest.platforms.$platform.checksum

    if (-not $checksum) {
        Write-Error "Platform $platform not found in manifest"
        exit 1
    }
}
catch {
    Write-Error "Failed to get manifest: $_"
    exit 1
}

# Download and verify
$binaryPath = "$DOWNLOAD_DIR\claude-$version-$platform.exe"
try {
    Invoke-WebRequest -Uri "$DOWNLOAD_BASE_URL/$version/$platform/claude.exe" -OutFile $binaryPath -ErrorAction Stop
}
catch {
    Write-Error "Failed to download binary: $_"
    if (Test-Path $binaryPath) {
        Remove-Item -Force $binaryPath
    }
    exit 1
}

# Calculate checksum
$actualChecksum = (Get-FileHash -Path $binaryPath -Algorithm SHA256).Hash.ToLower()

if ($actualChecksum -ne $checksum) {
    Write-Error "Checksum verification failed"
    Remove-Item -Force $binaryPath
    exit 1
}

# Run claude install to set up launcher and shell integration
Write-Output "Setting up Claude Code..."
try {
    if ($Target) {
        & $binaryPath install $Target
    }
    else {
        & $binaryPath install
    }
}
finally {
    try {
        # Clean up downloaded file
        # Wait a moment for any file handles to be released
        Start-Sleep -Seconds 1
        Remove-Item -Force $binaryPath
    }
    catch {
        Write-Warning "Could not remove temporary file: $binaryPath"
    }
}

Write-Output ""
Write-Output "$([char]0x2705) Installation complete!"
Write-Output ""

根据脚本内容，我们先要获取版本号，访问https://downloads.claude.ai/claude-code-releases/latest即可。

然后获取claude.exe本体，下载链接(以x64平台为例)为https://downloads.claude.ai/claude-code-releases/2.1.133/win32-x64/claude.exe，如果后有更新，可以更改这里的版本号获取最新版。

随后指定版本号并执行程序即可：.\claude.exe install 2.1.133

这时，我们需要将Claude的程序目录C:\Users\<yourname>\.local\bin\添加进系统环境变量，以便于直接claude命令启动。

CC-Switch应用

前往CC-Switch官网下载该应用，下面是该项目的简介：

CC Switch 把供应商切换、MCP / Prompts / Skills、代理接管、会话检索和云同步收进同一个桌面应用，你不再需要反复手改 JSON、TOML 或 .env。

这里以GLM Coding Plan的配置为例，API KEY、请求地址和主模型是最重要的三个配置，这里也对应到settings.json文件中的配置，随后启动ClaudeCode就可以跳过登录了。

ClaudeCode基础使用

# 进入项目文件夹
cd ./pjc1/

# 启动参数
# 新会话启动
claude
# 继续上次对话启动
claude -c
# 自动式(完全权限)启动
claude --dangerously-skip-permissions

# 使用过程中
# 检查安装情况
/doctor
# 加载之前的会话上下文
/resume
# 清除上下文
/clear
# 显示上下文占用
/context
# 适时压缩上下文
/compact
# 回滚历史会话与修改 (快捷键：两次Esc)
/rewind
# 审查做出的代码更改 (自动调优review)
/simplify
# 创建项目记忆文件 (CLAUDE.md)
/init
# 编辑记忆文件 (全局/项目/文件夹)
/memory
# 创建子agent (subagents)
/agent
# 指定文件
@anyfile.md
# 退出ClaudeCode会话 (快捷键：两次Ctrl+C)
/exit

# 命令帮助
/help
# 配置信息
/config
# 模型更改
/model
# Skill工具
/skills
# MCP工具
/mcp
# ClaudeCode插件
/plugin

快捷键	说明
`Shift+Tab`	切换工作模式
`Ctrl+Enter`	换行
`Esc`	取消当前操作 / 退出
`! <command>`	直接执行 shell 命令并返回输出

Git For Windows

请前往 Git For Windows 官网进行下载，关于Git相关的命令可以参考Git Book中文版并结合Agent来学习应用。

首先，Git本身作为代码版本管理工具，具有非常大的作用，方便我们随时保存和恢复代码版本；

其次在Windows系统下，Shell工具只有PowerShell和CMD，像Bash工具就需要通过WSL在Linux子系统中使用；

但Git Bash随着Git安装也会被安装，这就很好的为Agent提供了良好的命令行Shell环境，这也是ClaudeCode官方文档中推荐安装的原因。

Windows Defender 卸载程序 | Bluetooth Audio Receiver

Thu, 07 May 2026 00:00:00 GMT

Defender Remover

前往GitHub的release页下载对应版本的程序，随后以管理员方式运行即可。

Bluetooth Audio Receiver

打开PC的蓝牙和手机蓝牙，在手机端连接PC即可；

随后点击这里的设备，再点击Open Connection即可获取手机音频；

如果仍无声音，尝试切换一下PC的音频设备，一般就会恢复连接。

树莓派Pico2W实现无线DualSense手柄(PS5)的满血功能 | Raspberry Pi | Play Station5

Wed, 22 Apr 2026 00:00:00 GMT

使用简述

准备一根USB A to C的连接线
按住Pico2W的按钮，连接到PC电脑上，再松开按钮
打开识别到的新磁盘，存储空间大概在125MB左右
将项目中的.uf2文件拖入磁盘

等待磁盘消失后即为刷写成功

手柄连接

建议关掉连接过DualSense手柄设备的蓝牙开关

下载 PlayStation®Accessories ，并打开该程序。

同时按住DualSense手柄的 创建键(左上按钮) 和 Home键(中心PS-logo)，等待设备指示灯进入闪烁状态，即可进入配对状态；

观察Pico2W的指示灯是否亮起，如果未亮起，请保持DualSense手柄在配对状态时，重新插拔Pico2W，直至指示灯亮起，此时PlayStation®Accessories程序中应该会显示设备，连接成功。

关于

该项目截至2026-04-22,仅支持手柄设备的操作信号传输，无法支持DualSense原生扬声器、麦克风等功能。

使用Docker部署Umami统计服务 | Nginx | PostgreSQL

Sun, 19 Apr 2026 00:00:00 GMT

Docker-Compose配置

# 创建应用目录
cd ~
mkdir umami


# 编辑docker-compose.yml（参考下文配置）
# 请将<yourpassword>和<yourhashsalt>更改
nano ~/umami/docker-compose.yml

配置内容参考如下：

version: '3.9'
services:
  postgres:
    image: postgres:17-alpine
    container_name: umami-postgres
    restart: always
    environment:
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: <yourpassword>
      POSTGRES_DB: umami_db
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    networks:
      - umami-network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U umami -d umami_db"]
      interval: 5s
      timeout: 5s
      retries: 5
  umami:
    image: docker.umami.is/umami-software/umami:latest
    container_name: umami
    restart: always
    environment:
      DATABASE_URL: postgresql://umami:<yourpassword>@postgres:5432/umami_db
      DATABASE_TYPE: postgresql
      HASH_SALT: <yourhashsalt>
    ports:
      - "3001:3000"
    networks:
      - umami-network
    depends_on:
      postgres:
        condition: service_healthy
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
networks:
  umami-network:
    driver: bridge

随后启动容器：

# 可以先拉取所需的两个镜像
sudo docker pull postgres:17-alpine
sudo docker pull docker.umami.is/umami-software/umami:latest

# 拉取成功后启动容器
cd ~/umami
sudo docker compose up -d

PostgreSQL数据库备份与恢复

# 备份数据库
docker exec -t <容器名umami-postgres> pg_dump -U <用户名umami> -c <数据库名umami_db> > ~/backup.sql

# 恢复数据库
cat ~/backup.sql | docker exec -i <容器名umami-postgres> psql -U <用户名umami> <数据库名umami_db>

Nginx+Certbot配置

# 安装启动Nginx、Certbot
apt-get update && apt-get install -y nginx
systemctl enable nginx && systemctl start nginx
apt-get install -y certbot
apt-get install -y python3-certbot-nginx

# 申请SSL证书
# 将<your-domain>改为已在DNS处解析过的域名
sudo certbot certonly --nginx -d <your-domain>

# 编辑Nginx配置文件（参考下文）
nano /etc/nginx/sites-available/default

# 启用软链接
ln -s /etc/nginx/sites-available/default /etc/nginx/sites-enabled/default

# 测试文件格式
nginx -t

# 重载Nginx服务
systemctl reload nginx

配置文件内容参考：

# ==================== Umami - HTTP ====================
server {
    listen 80;
    server_name <your-domain>;


    # HTTP自动跳转HTTPS
    return 301 https://$host$request_uri;
}


# ==================== Umami - HTTPS ====================
server {
    listen 443 ssl http2;
    server_name <your-domain>;


    ssl_certificate /etc/letsencrypt/live/<your-domain>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<your-domain>/privkey.pem;


    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

默认账号密码：

Username: admin
Password: umami

结语

上述方法建立在长期使用，且有域名的前提下，此方法不需要开放云服务器厂商处的端口。
当然你可以使用宝塔、1Panel等服务器面板管理应用，一键安装配置。
如果你只是测试，可以不进行Nginx配置，只在docker容器跑通后，开放云服务器厂商的3001TCP端口，即可通过http://ip:3001访问Umami后台。

Docker部署自建Bitwarden密码管理器 | Nginx

Sat, 18 Apr 2026 00:00:00 GMT

Docker-Compose配置

# 进入用户目录，新建应用目录
cd ~
mkdir bitwarden

# 编辑compose文件(参考下文)
nano ~/bitwarden/docker-compose.yml

文件内容参考:

version: '3.9'
services:
    srprolin:
        image: 'vaultwarden/server:1.35.4'
        ports:
            - '3012:3012'
            - '8080:80'
        restart: unless-stopped
        volumes:
            - '/vw-data/:/data/'
        container_name: vaultwarden
        environment:
            - WEBSOCKET_ENABLED=true

你可以提前使用docker pull来拉取镜像。

随后，执行启动命令即可跑通该容器：

# 进入应用目录
cd ~/bitwarden

# 启动容器
sudo docker compose up -d

Nginx+Certbot配置

# 安装certbot
apt-get install -y certbot
apt-get install -y python3-certbot-nginx

# 申请Let's Encrypt的免费SSL证书
# 将<your-domain>改为已在DNS处解析过的域名
sudo certbot certonly --nginx -d <your-domain>

# 安装启动Nginx
apt-get update && apt-get install -y nginx
systemctl enable nginx && systemctl start nginx

# 编辑配置文件（参考下文）
nano /etc/nginx/sites-available/default

# 启用软链接
ln -s /etc/nginx/sites-available/default /etc/nginx/sites-enabled/default

# 测试文件格式
nginx -t

# 重载Nginx服务
systemctl reload nginx

配置文件内容参考：

# ==================== Bitwarden - HTTP ====================
server {
    listen 80;
    server_name <your-domain>;

    # HTTP自动跳转HTTPS
    return 301 https://$host$request_uri;
}

# ==================== Bitwarden - HTTPS ====================
server {
    listen 443 ssl http2;
    server_name <your-domain>;

    ssl_certificate /etc/letsencrypt/live/<your-domain>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<your-domain>/privkey.pem;

    location /notifications/hub {
        proxy_pass http://172.17.0.1:3012;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
    }

    location / {
        proxy_pass http://172.17.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

结语

上述方法建立在长期使用，且有域名的前提下，此方法不需要开放云服务器厂商处的端口。
当然你可以使用宝塔、1Panel等服务器面板管理应用，一键安装配置Bitwarden
如果你只是测试，可以不进行Nginx配置，只在docker容器跑通后，开放云服务器厂商的8080TCP端口，即可通过http://ip:8080访问vaultwarden后台。

使用Spire.Doc将代码块插入Word文档中 | Python

Thu, 16 Apr 2026 00:00:00 GMT

脚本说明

功能特性

扫描脚本所在目录下的代码文件（自动排除脚本自身，不会递归子目录）
自动识别文件语言并应用语法高亮
输出为 .docx Word 文档
统一使用 Consolas 等宽字体
默认字号约为 10.5pt
批量处理多个文件，逐个输出成功或失败结果

依赖要求

Python 3.10+
pygments
spire.doc

安装命令：

pip install pygments spire.doc

当前支持的代码文件类型

脚本当前会处理以下扩展名：

.m、.py、.c、.cpp、.java、.cs、.js、.ts、.go、.rs`

如果文件扩展名无法被 Pygments 正确识别，脚本会回退到 MatlabLexer 进行高亮处理。

使用方法

1. 准备代码文件

将需要转换的代码文件和 gen_word.py 放在同一个目录下。

例如：

code-to-word/
├── gen_word.py
├── main.py
├── utils.cpp
└── test.m

2. 运行脚本

在 code-to-word 目录中执行：

python gen_word.py

3. 查看输出结果

脚本会在当前目录下生成同名的 .docx 文件。

例如：

main.py    -> main.docx
utils.cpp  -> utils.docx
test.m     -> test.docx

脚本内容


"""
批量将代码文件转为带语法高亮的 Word 文档
依赖安装: pip install pygments spire.doc
"""

import os
from pygments import highlight
from pygments.lexers import MatlabLexer, get_lexer_for_filename
from pygments.formatters import RtfFormatter
from spire.doc import Document, FileFormat


CODE_DIR = os.path.dirname(os.path.abspath(__file__))
FONT_SIZE = r"\fs21"  # 10.5pt ≈ fs21


def code_to_rtf(code: str, lexer) -> str:
    """将代码转为 RTF 格式（带语法高亮）"""
    formatter = RtfFormatter(fontface="Consolas")
    rtf_text = highlight(code, lexer, formatter)
    # 设置字体大小
    rtf_text = rtf_text.replace(r"\f0", r"\f0" + FONT_SIZE)
    return rtf_text


def process_file(filepath: str) -> None:
    """将单个代码文件转为 Word 文档"""
    basename = os.path.basename(filepath)
    filename_no_ext = os.path.splitext(basename)[0]
    output_path = os.path.join(CODE_DIR, filename_no_ext + ".docx")

    # 读取代码
    with open(filepath, "r", encoding="utf-8") as f:
        code = f.read()

    # 自动识别语言
    try:
        lexer = get_lexer_for_filename(basename)
    except Exception:
        lexer = MatlabLexer()

    # 转为 RTF
    rtf_text = code_to_rtf(code, lexer)

    # 生成 Word 文档（新建空文档，不加载源文件）
    doc = Document()
    section = doc.AddSection()
    para = section.AddParagraph()
    para.AppendRTF(rtf_text)
    doc.SaveToFile(output_path, FileFormat.Docx2016)
    doc.Close()

    print(f"[OK] {basename} -> {filename_no_ext}.docx")


def main():
    # 支持的代码文件扩展名
    extensions = {".m", ".py", ".c", ".cpp", ".java", ".cs", ".js", ".ts", ".go", ".rs"}
    # 排除自身
    self_name = os.path.basename(os.path.abspath(__file__))

    files = [
        f for f in os.listdir(CODE_DIR)
        if os.path.isfile(os.path.join(CODE_DIR, f))
        and f != self_name
        and os.path.splitext(f)[1].lower() in extensions
    ]

    if not files:
        print("未找到代码文件")
        return

    print(f"找到 {len(files)} 个代码文件，开始转换...\n")

    for f in sorted(files):
        filepath = os.path.join(CODE_DIR, f)
        try:
            process_file(filepath)
        except Exception as e:
            print(f"[FAIL] {f}: {e}")

    print(f"\n完成！文件保存在: {CODE_DIR}")


if __name__ == "__main__":
    main()

个人脚本仓库

::github{repo="RolinShmily/SrP-Scripts"}

如果觉得有用，欢迎给个 Star！如果有问题或建议，欢迎提 Issue 或 PR。

使用yt-dlp下载互联网上的任何音视频 | FFmpeg | Python

Mon, 13 Apr 2026 00:00:00 GMT

yt-dlp 实用工具集

基于 yt-dlp 封装的 Python 脚本工具集，提供一键下载、自动转码功能。

脚本说明

依赖

Python 3.10+
FFmpeg

安装 yt-dlp 完整版：

pip install "yt-dlp[default]"

quick_grab.py — 快速获取视频

下载任意网站视频，自动确保输出为 H.264 + AAC 的 MP4 文件。

特性：

自动检测并使用 GPU 硬件加速（NVIDIA NVENC / AMD AMF / Intel QSV），无 GPU 回退 CPU
探测源视频码率，按源码率匹配目标画质，避免转码后文件暴涨
支持断点续传，网络中断后重新运行可从上次位置继续
内置失败重试（10 次重试 + 指数退避）

基本用法：

# 下载最高画质（自动转码为 H.264 MP4）
python quick_grab.py "https://www.youtube.com/watch?v=VIDEO_ID"

# 指定输出目录
python quick_grab.py "URL" -d D:/Downloads

# 下载 720P
python quick_grab.py "URL" -q 720

# 仅下载音频
python quick_grab.py "URL" --audio

# 下载中英字幕
python quick_grab.py "URL" --subtitle

# 下载整个播放列表
python quick_grab.py "URL" --playlist

# 自定义编码质量（CRF 越小质量越高，默认 23）
python quick_grab.py "URL" --crf 18 --preset slow

# 强制使用 CPU 编码（禁用 GPU 加速）
python quick_grab.py "URL" --no-gpu

# 指定输出文件名
python quick_grab.py "URL" -o "my_video.mp4"

转码流程：

yt-dlp 下载视频（自动合并视频+音频流）
ffprobe 检测编码格式
如果已经是 H.264 + AAC + MP4 → 跳过（无需转码）
如果编码正确但容器非 MP4 → 仅 remux（无损，极快）
如果需要转码 → 自动探测源码率，按源码率匹配目标画质：
- NVENC：-rc vbr -cq -b:v {源码率}k -maxrate {源码率}k
- AMF/QSV：类似 VBR 码率控制
- CPU：高码率用 -b:v 码率模式，低/未知码率用 -crf 质量模式
- 低码率（< 2000k）自动降低 CRF 至 20 以保画质

quick_audio.py — 快速获取音频

下载任意网站音频，转为 AAC 编码的 M4A 文件，兼容 iPhone / Android / Windows / Mac / 车载等所有主流播放器。

基本用法：

# 下载音频，输出 AAC/M4A (192kbps)
python quick_audio.py "https://www.youtube.com/watch?v=VIDEO_ID"

# 指定输出目录
python quick_audio.py "URL" -d D:/Downloads

# 320kbps 高音质
python quick_audio.py "URL" -b 320

# 输出 MP3 格式（兼容极老旧设备）
python quick_audio.py "URL" --mp3

# 下载整个播放列表的音频
python quick_audio.py "URL" --playlist

脚本内容

quick_grab.py

"""
快速获取 - 使用 yt-dlp 下载任意网站视频，确保输出 H.264 + AAC MP4

ffmpeg 调用链:
  1. yt-dlp 内部调用 ffmpeg 合并分离的视频/音频流 (自动, -c copy)
  2. 脚本调用 ffprobe 检测编码格式
  3. 自动检测 GPU (NVIDIA NVENC), 优先使用硬件加速转码
  4. 如需转码, 有 GPU 时用 h264_nvenc, 无 GPU 时用 libx264 + aac
  5. 如编码已正确但容器非 mp4, 仅做 remux (-c copy 到 mp4 容器)

用法:
    python quick_grab.py <URL>
    python quick_grab.py <URL> -d D:/Downloads
    python quick_grab.py <URL> --audio
    python quick_grab.py <URL> -q 720
    python quick_grab.py <URL> --crf 18 --preset slow   # 高质量转码
"""

import argparse
import io
import os
import subprocess
import sys

# Fix Windows console encoding
if sys.platform == "win32":
    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")


# ---------------------------------------------------------------------------
# ffmpeg / ffprobe helpers
# ---------------------------------------------------------------------------

def probe_codecs(filepath: str) -> tuple[str, str]:
    """用 ffprobe 检测视频和音频编码格式"""
    result = subprocess.run(
        ["ffprobe", "-v", "error",
         "-show_entries", "stream=codec_type,codec_name",
         "-of", "csv=p=0", filepath],
        capture_output=True, text=True, timeout=10,
        encoding="utf-8", errors="replace",
    )
    vcodec = acodec = "none"
    for line in result.stdout.strip().split("\n"):
        # ffprobe csv=p=0 输出格式: codec_name,codec_type (如 "h264,video")
        parts = line.strip().split(",")
        if len(parts) == 2:
            cname, ctype = parts
            if ctype == "video":
                vcodec = cname
            elif ctype == "audio":
                acodec = cname
    return vcodec, acodec


def remux_to_mp4(input_path: str) -> bool:
    """仅更换容器为 mp4 (不重新编码, 极快)"""
    output_path = os.path.splitext(input_path)[0] + ".mp4"
    if input_path == output_path:
        return True
    cmd = [
        "ffmpeg", "-i", input_path,
        "-c", "copy", "-movflags", "+faststart",
        "-y", output_path,
    ]
    result = subprocess.run(cmd)
    if result.returncode == 0 and os.path.isfile(output_path):
        os.remove(input_path)
        return True
    if os.path.isfile(output_path):
        os.remove(output_path)
    return False


def _detect_nvenc() -> bool:
    """检测 ffmpeg 是否支持 NVIDIA NVENC 硬件编码"""
    try:
        result = subprocess.run(
            ["ffmpeg", "-hide_banner", "-encoders"],
            capture_output=True, text=True, timeout=10,
            encoding="utf-8", errors="replace",
        )
        return "h264_nvenc" in result.stdout
    except (FileNotFoundError, subprocess.TimeoutExpired):
        return False


def _detect_hardware_encoder() -> str:
    """检测可用的硬件编码器, 返回编码器名称 (h264_nvenc / h264_amf / h264_qsv / libx264)"""
    try:
        result = subprocess.run(
            ["ffmpeg", "-hide_banner", "-encoders"],
            capture_output=True, text=True, timeout=10,
            encoding="utf-8", errors="replace",
        )
        for enc in ("h264_nvenc", "h264_amf", "h264_qsv"):
            if enc in result.stdout:
                return enc
    except (FileNotFoundError, subprocess.TimeoutExpired):
        pass
    return "libx264"


def _probe_source_bitrate(filepath: str) -> int:
    """获取源视频流码率 (kbps), 获取失败返回 0"""
    # 优先从流信息获取
    try:
        result = subprocess.run(
            ["ffprobe", "-v", "error",
             "-select_streams", "v:0",
             "-show_entries", "stream=bit_rate",
             "-of", "csv=p=0", filepath],
            capture_output=True, text=True, timeout=10,
            encoding="utf-8", errors="replace",
        )
        br = result.stdout.strip()
        if br and br not in ("N/A", ""):
            return int(br) // 1000  # bps → kbps
    except (FileNotFoundError, subprocess.TimeoutExpired, ValueError):
        pass
    # 回退: 从文件大小 × 时长估算
    try:
        result = subprocess.run(
            ["ffprobe", "-v", "error",
             "-show_entries", "format=duration",
             "-of", "csv=p=0", filepath],
            capture_output=True, text=True, timeout=10,
            encoding="utf-8", errors="replace",
        )
        duration = float(result.stdout.strip())
        file_size = os.path.getsize(filepath)
        return int(file_size * 8 / duration * 0.85 / 1000)  # 视频约占85%
    except (FileNotFoundError, subprocess.TimeoutExpired, ValueError, OSError):
        return 0


def transcode(input_path: str, crf: int = 23, preset: str = "medium",
              use_gpu: bool = True) -> bool:
    """转码为 H.264 + AAC MP4 (参考源码率匹配画质, 优先硬件加速)"""
    base, ext = os.path.splitext(input_path)
    output_path = base + "_h264_tmp.mp4"

    # 探测源视频码率
    source_kbps = _probe_source_bitrate(input_path)
    # CRF 根据源码率调整: 低码率用更高质量
    crf_value = 20 if 0 < source_kbps < 2000 else crf
    # 缓冲区 = 码率 × 2
    buf_kbps = source_kbps * 2 if source_kbps > 0 else 0

    # 选择编码器
    encoder = _detect_hardware_encoder() if use_gpu else "libx264"

    # --- NVENC ---
    if encoder == "h264_nvenc":
        _preset_map = {
            "ultrafast": "p1", "superfast": "p1", "veryfast": "p2",
            "faster": "p3", "fast": "p4", "medium": "p4",
            "slow": "p5", "slower": "p7", "veryslow": "p7",
        }
        nvenc_preset = _preset_map.get(preset, "p4")
        if source_kbps > 0:
            print(f"    [GPU/NVENC] 源码率: {source_kbps}k | 目标: {source_kbps}k | cq={crf_value} | preset={nvenc_preset}")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "h264_nvenc", "-preset", nvenc_preset,
                "-rc", "vbr", "-cq", str(crf_value),
                "-b:v", f"{source_kbps}k", "-maxrate", f"{source_kbps}k", "-bufsize", f"{buf_kbps}k",
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]
        else:
            print(f"    [GPU/NVENC] 未知源码率 | cq={crf_value} | preset={nvenc_preset}")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "h264_nvenc", "-preset", nvenc_preset,
                "-rc", "vbr", "-cq", str(crf_value),
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]

    # --- AMD AMF ---
    elif encoder == "h264_amf":
        if source_kbps > 0:
            print(f"    [GPU/AMF] 源码率: {source_kbps}k | 目标: {source_kbps}k")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "h264_amf", "-quality", "speed", "-rc", "vbr",
                "-b:v", f"{source_kbps}k", "-maxrate", f"{source_kbps}k", "-bufsize", f"{buf_kbps}k",
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]
        else:
            print(f"    [GPU/AMF] 未知源码率")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "h264_amf", "-quality", "speed", "-rc", "vbr",
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]

    # --- Intel QSV ---
    elif encoder == "h264_qsv":
        if source_kbps > 0:
            print(f"    [GPU/QSV] 源码率: {source_kbps}k | 目标: {source_kbps}k | quality={crf_value}")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "h264_qsv", "-preset", "medium",
                "-b:v", f"{source_kbps}k", "-maxrate", f"{source_kbps}k", "-bufsize", f"{buf_kbps}k",
                "-global_quality", str(crf_value),
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]
        else:
            print(f"    [GPU/QSV] 未知源码率 | quality={crf_value}")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "h264_qsv", "-preset", "medium",
                "-global_quality", str(crf_value),
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]

    # --- CPU libx264 ---
    else:
        if source_kbps > 0 and source_kbps >= 2000:
            print(f"    [CPU/x264] 源码率: {source_kbps}k | 目标: {source_kbps}k | preset={preset}")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "libx264", "-preset", preset,
                "-b:v", f"{source_kbps}k", "-maxrate", f"{source_kbps}k", "-bufsize", f"{buf_kbps}k",
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]
        else:
            print(f"    [CPU/x264] 未知/低码率 | crf={crf_value} | preset={preset}")
            cmd = [
                "ffmpeg", "-i", input_path,
                "-c:v", "libx264", "-preset", preset, "-crf", str(crf_value),
                "-c:a", "aac", "-b:a", "192k",
                "-movflags", "+faststart", "-y", output_path,
            ]

    result = subprocess.run(cmd)

    if result.returncode == 0 and os.path.isfile(output_path):
        os.replace(output_path, base + ".mp4")
        # 清理原始文件 (如果扩展名不同)
        original = input_path
        if os.path.isfile(original) and original != base + ".mp4":
            os.remove(original)
        return True

    if os.path.isfile(output_path):
        os.remove(output_path)
    return False


# ---------------------------------------------------------------------------
# yt-dlp helpers
# ---------------------------------------------------------------------------

def _progress_hook(d: dict):
    """yt-dlp 下载进度回调"""
    if d["status"] == "downloading":
        pct = d.get("_percent_str", "?")
        spd = d.get("_speed_str", "?")
        eta = d.get("_eta_str", "?")
        print(f"\r  下载中: {pct} | 速度: {spd} | 剩余: {eta}", end="", flush=True)
    elif d["status"] == "finished":
        print("\n  下载完成，正在合并...")


def _find_output_file(ydl, info: dict) -> str | None:
    """根据 yt-dlp info 定位实际输出文件"""
    expected = ydl.prepare_filename(info)
    if os.path.isfile(expected):
        return expected
    # 合并后扩展名可能变为 mp4
    base, _ = os.path.splitext(expected)
    for ext in (".mp4", ".mkv", ".webm", ".ts"):
        if os.path.isfile(base + ext):
            return base + ext
    return None


# ---------------------------------------------------------------------------
# 主流程
# ---------------------------------------------------------------------------

def grab(url: str, output_dir: str = ".", output_name: str | None = None,
         audio_only: bool = False, quality: int | None = None,
         playlist: bool = False, subtitle: bool = False,
         crf: int = 23, preset: str = "medium", use_gpu: bool = True) -> int:
    """下载视频并确保 H.264 + AAC MP4 输出"""
    try:
        import yt_dlp
    except ImportError:
        print("错误: 未安装 yt-dlp，请先执行 pip install yt-dlp")
        return 1

    os.makedirs(output_dir, exist_ok=True)

    outtmpl = (os.path.join(output_dir, output_name) if output_name
               else os.path.join(output_dir, "%(title)s.%(ext)s"))

    ydl_opts: dict = {
        "outtmpl": outtmpl,
        "progress_hooks": [_progress_hook],
        # 断点续传 & 重试
        "continuedl": True,
        "retries": 10,
        "fragment_retries": 10,
        "file_access_retries": 10,
        "retry_sleep_functions": {"http": 5, "fragment": 5, "file_access": 3},
    }

    # 格式选择
    if audio_only:
        ydl_opts["format"] = "bestaudio/best"
        ydl_opts["postprocessors"] = [{
            "key": "FFmpegExtractAudio",
            "preferredcodec": "best",
        }]
    elif quality:
        ydl_opts["format"] = (
            f"bestvideo[height<={quality}]+bestaudio"
            f"/best[height<={quality}]/best"
        )
        ydl_opts["merge_output_format"] = "mp4"
    else:
        ydl_opts["format"] = "bestvideo+bestaudio/best"
        ydl_opts["merge_output_format"] = "mp4"

    if not playlist:
        ydl_opts["noplaylist"] = True
    if subtitle:
        ydl_opts["writesubs"] = True
        ydl_opts["writeautomaticsub"] = True
        ydl_opts["subtitleslangs"] = ["zh", "en"]

    print(f"\n正在获取: {url}\n")

    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
        info = ydl.extract_info(url, download=True)

    if info is None:
        print("错误: 无法获取视频信息")
        return 1

    # --- 后处理: 确保 H.264 + AAC MP4 ---
    if audio_only:
        print("\n音频模式，跳过视频编码检查。")

    else:
        # 收集所有需要检查的文件
        if "entries" in info:
            entries = [e for e in info["entries"] if e]
        else:
            entries = [info]

        print("\n[ 编码检查 ]")
        for entry in entries:
            filepath = _find_output_file(ydl, entry)
            if not filepath:
                continue

            vcodec, acodec = probe_codecs(filepath)
            name = os.path.basename(filepath)
            print(f"  {name}")
            print(f"    视频编码: {vcodec} | 音频编码: {acodec}")

            is_h264 = vcodec == "h264"
            is_aac = acodec in ("aac", "none")
            is_mp4 = filepath.lower().endswith(".mp4")

            if is_h264 and is_aac and is_mp4:
                print("    ✓ 已是 H.264 + AAC MP4，跳过")

            elif is_h264 and is_aac and not is_mp4:
                print("    → 编码正确，封装为 MP4...")
                if remux_to_mp4(filepath):
                    print("    ✓ 封装完成 (remux, 无损)")
                else:
                    print("    ✗ 封装失败，保留原始文件")

            else:
                print(f"    → 需要转码 ({vcodec}/{acodec} → h264/aac)...")
                if transcode(filepath, crf=crf, preset=preset, use_gpu=use_gpu):
                    print("    ✓ 转码完成")
                else:
                    print("    ✗ 转码失败，保留原始文件")

    print("\n全部完成!")
    return 0


def main():
    p = argparse.ArgumentParser(
        description="快速获取 - 下载任意网站视频 (H.264 + AAC MP4)",
    )
    p.add_argument("url", help="视频 URL")
    p.add_argument("-o", "--output", help="输出文件名")
    p.add_argument("-d", "--output-dir", default=".", help="输出目录 (默认: 当前目录)")
    p.add_argument("-a", "--audio", action="store_true", help="仅下载音频")
    p.add_argument("-q", "--quality", type=int, help="最高分辨率 (如 720, 1080)")
    p.add_argument("-p", "--playlist", action="store_true", help="下载整个播放列表")
    p.add_argument("-s", "--subtitle", action="store_true", help="下载字幕")
    p.add_argument("--crf", type=int, default=23,
                   help="H.264 CRF 质量值 (默认: 23, 范围 0-51, 越小质量越高)")
    p.add_argument("--preset", default="medium",
                   choices=["ultrafast", "superfast", "veryfast", "faster",
                            "fast", "medium", "slow", "slower", "veryslow"],
                   help="编码速度预设 (默认: medium)")
    p.add_argument("--no-gpu", action="store_true",
                   help="禁用 GPU 加速, 强制使用 CPU 软编码")

    args = p.parse_args()
    sys.exit(grab(
        url=args.url,
        output_dir=args.output_dir,
        output_name=args.output,
        audio_only=args.audio,
        quality=args.quality,
        playlist=args.playlist,
        subtitle=args.subtitle,
        crf=args.crf,
        preset=args.preset,
        use_gpu=not args.no_gpu,
    ))


if __name__ == "__main__":
    main()

quick_audio.py

"""
快速获取音频 - 使用 yt-dlp 下载任意网站音频，转为 AAC 编码的 M4A 文件

输出 M4A (AAC) — 兼容 iPhone / Android / Windows / Mac / 车载 / 所有主流播放器。
可选 --mp3 输出 MP3 格式以兼容极老旧设备。

用法:
    python quick_audio.py <URL>
    python quick_audio.py <URL> -d D:/Downloads
    python quick_audio.py <URL> -b 320       # 320kbps 高音质
    python quick_audio.py <URL> --mp3         # 输出 MP3 格式
"""

import argparse
import io
import os
import subprocess
import sys

# Fix Windows console encoding
if sys.platform == "win32":
    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")


# ---------------------------------------------------------------------------
# helpers
# ---------------------------------------------------------------------------

def _progress_hook(d: dict):
    """yt-dlp 下载进度回调"""
    if d["status"] == "downloading":
        pct = d.get("_percent_str", "?")
        spd = d.get("_speed_str", "?")
        eta = d.get("_eta_str", "?")
        print(f"\r  下载中: {pct} | 速度: {spd} | 剩余: {eta}", end="", flush=True)
    elif d["status"] == "finished":
        print("\n  下载完成，正在处理音频...")


def _find_file(ydl, info: dict) -> str | None:
    """定位 yt-dlp 实际输出的文件"""
    expected = ydl.prepare_filename(info)
    if os.path.isfile(expected):
        return expected
    base, _ = os.path.splitext(expected)
    for ext in (".m4a", ".mp3", ".ogg", ".opus", ".webm", ".wav", ".flac", ".wma", ".aac"):
        if os.path.isfile(base + ext):
            return base + ext
    return None


def _probe_audio_codec(filepath: str) -> str:
    """检测音频编码格式"""
    result = subprocess.run(
        ["ffprobe", "-v", "error",
         "-select_streams", "a:0",
         "-show_entries", "stream=codec_name",
         "-of", "csv=p=0", filepath],
        capture_output=True, text=True, timeout=10,
        encoding="utf-8", errors="replace",
    )
    return result.stdout.strip() or "unknown"


def _convert(input_path: str, bitrate: int = 192, output_mp3: bool = False) -> bool:
    """转码音频为 AAC/M4A 或 MP3"""
    base, _ = os.path.splitext(input_path)
    target_ext = ".mp3" if output_mp3 else ".m4a"
    output_path = base + "_tmp" + target_ext

    if output_mp3:
        codec = "libmp3lame"
        quality_arg = ["-b:a", f"{bitrate}k"]
        print(f"    → 转码为 MP3 ({bitrate}kbps)...")
    else:
        codec = "aac"
        quality_arg = ["-b:a", f"{bitrate}k"]
        print(f"    → 转码为 AAC/M4A ({bitrate}kbps)...")

    cmd = [
        "ffmpeg", "-i", input_path,
        "-c:a", codec, *quality_arg,
        "-movflags", "+faststart",
        "-y", output_path,
    ]
    result = subprocess.run(cmd)

    if result.returncode == 0 and os.path.isfile(output_path):
        final_path = base + target_ext
        os.replace(output_path, final_path)
        # 清理原始文件
        if os.path.isfile(input_path) and input_path != final_path:
            os.remove(input_path)
        return True

    if os.path.isfile(output_path):
        os.remove(output_path)
    return False


# ---------------------------------------------------------------------------
# 主流程
# ---------------------------------------------------------------------------

def grab_audio(url: str, output_dir: str = ".", output_name: str | None = None,
               bitrate: int = 192, playlist: bool = False,
               output_mp3: bool = False) -> int:
    """下载音频并转为 AAC/M4A 或 MP3"""
    try:
        import yt_dlp
    except ImportError:
        print("错误: 未安装 yt-dlp，请先执行 pip install yt-dlp")
        return 1

    os.makedirs(output_dir, exist_ok=True)

    target_ext = ".mp3" if output_mp3 else ".m4a"
    outtmpl = (os.path.join(output_dir, output_name) if output_name
               else os.path.join(output_dir, "%(title)s.%(ext)s"))

    ydl_opts: dict = {
        "outtmpl": outtmpl,
        "format": "bestaudio/best",
        "progress_hooks": [_progress_hook],
        # 断点续传 & 重试
        "continuedl": True,
        "retries": 10,
        "fragment_retries": 10,
        "file_access_retries": 10,
        "retry_sleep_functions": {"http": 5, "fragment": 5, "file_access": 3},
    }

    if not playlist:
        ydl_opts["noplaylist"] = True

    target_format = "MP3" if output_mp3 else "AAC/M4A"
    print(f"\n正在获取音频 ({target_format}, {bitrate}kbps): {url}\n")

    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
        info = ydl.extract_info(url, download=True)

    if info is None:
        print("错误: 无法获取音频信息")
        return 1

    # 收集条目
    if "entries" in info:
        entries = [e for e in info["entries"] if e]
    else:
        entries = [info]

    # 目标编码
    target_codec = "mp3" if output_mp3 else "aac"

    print(f"\n[ 音频检查 ]")
    for entry in entries:
        filepath = _find_file(ydl, entry)
        if not filepath:
            print(f"  ⚠ 未找到文件: {entry.get('title', '?')}")
            continue

        name = os.path.basename(filepath)
        codec = _probe_audio_codec(filepath)
        _, ext = os.path.splitext(filepath)
        is_target = (codec == target_codec and ext.lower() == target_ext)

        print(f"  {name}")
        print(f"    编码: {codec}")

        if is_target:
            print(f"    ✓ 已是目标格式 ({target_codec}{target_ext})，跳过")
        else:
            _convert(filepath, bitrate=bitrate, output_mp3=output_mp3)
            print(f"    ✓ 转码完成 → {target_codec}{target_ext}")

    print("\n全部完成!")
    return 0


def main():
    p = argparse.ArgumentParser(
        description="快速获取音频 - 下载任意网站音频 (AAC/M4A 或 MP3)",
    )
    p.add_argument("url", help="音频/视频 URL")
    p.add_argument("-d", "--output-dir", default=".", help="输出目录 (默认: 当前目录)")
    p.add_argument("-o", "--output", help="输出文件名")
    p.add_argument("-b", "--bitrate", type=int, default=192,
                   help="音频码率 kbps (默认: 192, 建议: 128/192/256/320)")
    p.add_argument("-p", "--playlist", action="store_true", help="下载整个播放列表")
    p.add_argument("--mp3", action="store_true",
                   help="输出 MP3 格式 (默认: AAC/M4A)")
    args = p.parse_args()

    sys.exit(grab_audio(
        url=args.url,
        output_dir=args.output_dir,
        output_name=args.output,
        bitrate=args.bitrate,
        playlist=args.playlist,
        output_mp3=args.mp3,
    ))


if __name__ == "__main__":
    main()

个人脚本仓库

::github{repo="RolinShmily/SrP-Scripts"}

如果觉得有用，欢迎给个 Star！如果有问题或建议，欢迎提 Issue 或 PR。

LGnewUI-2 部署 | Docker | PHP | MySQL | Nginx | Certbot

Fri, 03 Apr 2026 00:00:00 GMT

项目资源获取

LGnewUI-2采用授权下载方式，需要在 LGNewUi-Auth - 情侣小站在线授权系统登录并经授权后，下载项目源代码。

Docker的安装配置

参考阿里云给出的文档,按序执行即可:

#删除Docker相关源
sudo rm -f /etc/apt/sources.list.d/*docker*.list
#卸载Docker和相关的软件包
for pkg in docker.io docker-buildx-plugin docker-ce-cli docker-ce-rootless-extras docker-compose-plugin docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove -y $pkg; done

#添加 GPG 密钥
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL http://mirrors.cloud.aliyuncs.com/docker-ce/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
#将该软件源添加到 Apt 源列表中。
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: http://mirrors.cloud.aliyuncs.com/docker-ce/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
#安装Docker社区版本，容器运行时containerd.io，以及Docker构建和Compose插件
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

#启动Docker
sudo systemctl start docker
#设置Docker守护进程在系统启动时自动启动
sudo systemctl enable docker

配置镜像源:

sudo nano /etc/docker/daemon.json

轩辕镜像一键配置脚本:

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

镜像源配置示例：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live/"
  ]
}

如果配置后仍然无法拉取(docker pull)镜像，请考虑使用科学上网工具。

对于不同设备，可以使用以下命令传输离线镜像包：

# 拉取镜像(设备1)
docker pull ...

# 打包镜像(设备1) | <path>/<name>.tar为自定义路径的tar文件，<image_name>为拉取的镜像名称
docker save -o <path>/<name>.tar <image_name>

# 将<name>.tar上传到服务器中，然后加载镜像(设备2--服务器)
docker load -i <path>/<name>.tar

MySQL的compose配置

# 创建docker文件夹
mkdir ~/mysql57

# [2h2g3m小水管服务器] 创建 MySQL 自定义优化配置文件(参考下文给出的 low-memory.cnf)
sudo mkdir -p /data/mysql/conf
sudo nano /data/mysql/conf/low-memory.cnf

# 编辑mysql的docker-compose(参考下文给出的 docker-compose.yml)
nano ~/mysql57/docker-compose.yml

# low-memory.cnf
[mysqld]
# ===== 内存核心调优 =====
innodb_buffer_pool_size = 256M
innodb_buffer_pool_instances = 1

# ===== 连接优化 =====
max_connections = 30            
thread_cache_size = 4
table_open_cache = 64
table_definition_cache = 256

# ===== 临时表和排序 =====
tmp_table_size = 16M
max_heap_table_size = 16M
sort_buffer_size = 256K        
join_buffer_size = 256K
read_buffer_size = 128K
read_rnd_buffer_size = 128K

# ===== 日志优化 =====
innodb_log_file_size = 32M
innodb_log_buffer_size = 4M
innodb_flush_log_at_trx_commit = 2
sync_binlog = 0                 

# ===== 其他 =====
performance_schema = OFF        
innodb_flush_method = O_DIRECT
skip-name-resolve    
max_allowed_packet = 64M

# docker-compose.yml
version: '3.9'
services:
    mysql:
        image: 'mysql:5.7.44'
        volumes:
            - '/data/mysql:/var/lib/mysql'
            # 优化配置文件
            - '/data/mysql/conf:/etc/mysql/conf.d'
        environment:
            - MYSQL_DATABASE=LGnewUI2
            - MYSQL_ROOT_PASSWORD=yourpassword
        ports:
            - '3306:3306'
        restart: always
        container_name: mysql57
        # 内存限制(优化)
        deploy:
            resources:
                limits:
                    memory: 512M
                reservations:
                    memory: 256M
        # MySQL启动参数(优化)
        command: >
            --character-set-server=utf8mb4
            --collation-server=utf8mb4_general_ci
            --default-storage-engine=InnoDB

可以先拉取镜像，或者参考上一节的内容，加载离线镜像包:

# 拉取镜像 (方式1)
sudo docker pull mysql:5.7.44

# 加载镜像 (方式2)
sudo docker load -i <path>/<name>.tar

随后就可以启用容器了:

cd ~/mysql57
sudo docker compose up -d

PHP-FPM的compose配置

笔者已将构建好的镜像 rol1n/lgnewui2-php74-fpm:latest 上传至 Docker Hub 由于需要安装PHP的一些拓展和依赖，纯净的官方镜像并不能满足需求，所以需要：

从 Dockerfile 配置本地构建新镜像

# 创建docker文件夹
mkdir ~/php74-fpm

# 拉取官方纯净镜像
sudo docker pull php:7.4-fpm

# 将SourceGuardian加密文件放进构建目录，这里以x86-64文件为例
cd ~/php74-fpm/build
wget https://raw.githubusercontent.com/BaseMax/sourceguardian-loader-linux-x86-64/refs/heads/main/ixed.7.4.lin

# 创建构建目录并编辑 Dockerfile(参考下文给出的 Dockerfile)
mkdir -p ~/php74-fpm/build  
nano ~/php74-fpm/build/Dockerfile

# [2h2g3m小水管服务器] 创建 PHP-FPM 自定义优化配置(参考下文给出的 zz-cusom.conf)
sudo mkdir -p /data/php/conf
sudo nano /data/php/conf/zz-custom.conf

# [2h2g3m小水管服务器] 创建 PHP 自定义优化 ini 配置(参考下文给出的 performance.ini)
sudo mkdir -p /data/php/php-conf
sudo nano /data/php/php-conf/performance.ini

# 编辑php-fpm的docker-compose(参考下文给出的 docker-compose.yml)
nano ~/php74-fpm/docker-compose.yml

# Dockerfile
FROM php:7.4-fpm

# ===== 换阿里云apt源 =====
RUN echo "deb http://mirrors.aliyun.com/debian bullseye main contrib non-free" > /etc/apt/sources.list \
 && echo "deb http://mirrors.aliyun.com/debian-security bullseye-security main contrib non-free" >> /etc/apt/sources.list

# ===== 安装系统依赖 =====
RUN apt-get update && apt-get install -y --no-install-recommends \
    libpng-dev libjpeg-dev libwebp-dev libzip-dev libicu-dev \
    libmagickwand-dev default-mysql-client ffmpeg \
 && rm -rf /var/lib/apt/lists/*

# ===== PHP内置扩展 =====
RUN docker-php-ext-install pdo_mysql mysqli exif

# GD扩展（图片处理）
RUN docker-php-ext-configure gd --with-jpeg --with-webp \
 && docker-php-ext-install gd

# Zip扩展（压缩）
RUN docker-php-ext-install zip

# Intl扩展（国际化）
RUN docker-php-ext-install intl

# ===== PECL扩展 =====
RUN pecl install imagick && docker-php-ext-enable imagick

# ===== SourceGuardian =====
# 将 ixed.7.4.lin 放在同目录下，构建时复制进去
COPY ixed.7.4.lin /usr/local/lib/php/extensions/no-debug-non-zts-20190902/
RUN echo "extension=ixed.7.4.lin" > /usr/local/etc/php/conf.d/ixed.ini \
 && echo "sourceguardian.enable_vm_hybrid=1" >> /usr/local/etc/php/conf.d/ixed.ini

# ===== PHP基础配置 =====
RUN echo "upload_max_filesize = 20M" > /usr/local/etc/php/conf.d/custom.ini \
 && echo "post_max_size = 20M" >> /usr/local/etc/php/conf.d/custom.ini

; zz-cusom.conf
[www]
; 进程管理 - 动态模式
pm = dynamic
pm.max_children = 8             
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
pm.max_requests = 200      

; 慢日志（排查问题用）
slowlog = /var/log/php-fpm-slow.log
request_slowlog_timeout = 3s

; performance.ini
; 内存限制
memory_limit = 128M              
; OPcache 优化
[opcache]
opcache.enable = 1
opcache.memory_consumption = 32        
opcache.interned_strings_buffer = 4
opcache.max_accelerated_files = 2000    
opcache.validate_timestamps = 0        
opcache.save_comments = 1
opcache.fast_shutdown = 1
; 执行时间限制
max_execution_time = 120
max_input_time = 120

# docker-compose.yml
version: '3.9'
services:
    php:
        build:
            context: ./build      
            dockerfile: Dockerfile
        image: 'lgnewui2-php74-fpm'
        ports:
            - '9000:9000'
        volumes:
            - '/var/www:/var/www'
            # PHP-FPM优化配置
            - '/data/php/conf/zz-custom.conf:/usr/local/etc/php-fpm.d/zz-custom.conf'  
            # PHP优化配置
            - '/data/php/php-conf:/usr/local/etc/php/conf.d/custom-performance'          
        restart: always
        container_name: php74-fpm
        # 内存限制(优化)
        deploy:
            resources:
                limits:
                    memory: 512M
                reservations:
                    memory: 256M

# 进入根目录
cd ~/php74-fpm

# 构建镜像
sudo docker compose build

# 启动容器
sudo docker compose up -d

MySQL与PHP通信

我们需要创建新的docker网络，用于连通php与mysql：

sudo docker network create mynet
sudo docker network connect mynet php74-fpm
sudo docker network connect mynet mysql57

Nginx、Certbot安装与配置(网站上线)

# 使用apt-get获取nginx、certbot
apt-get update && apt-get install -y nginx
apt-get install -y certbot
apt-get install -y python3-certbot-nginx

# 开机自启动与即刻运行nginx
systemctl enable nginx && systemctl start nginx

创建源码存放目录，并上传资源：

# 需要以root身份
mkdir /var/www/love
cd /var/www/love
# 随后通过SFTP等工具上传源码至此

使用certbot(自动续签)申请ssl证书(确保域名都已在DNS处解析过)：

# 将<your-main-domain>更换为你的主要站点域名
sudo certbot certonly --nginx -d <your-main-domain>

# 一些相关命令
# 查看所有已安装的证书
sudo certbot certificates
# 删除证书
sudo certbot delete --cert-name example.com

<your-main-domain>示例: love.example.com | 作为主要访问地址

编辑Nginx配置文件，并上线网站:

# 编辑配置(参考下文)
sudo nano /etc/nginx/sites-available/default

# 创建启用软链接
ln -s /etc/nginx/sites-available/default /etc/nginx/sites-enabled/default

# 测试配置格式正确否
nginx -t

# 重载nginx使配置生效
sudo systemctl reload nginx

Nginx(LGnewUI-2)配置文件(将<your-main-domain>替换为自定义域名):

# ==================== Love站点 - HTTP ====================
server {
    listen 80;
    server_name <your-main-domain>;

    # HTTP自动跳转HTTPS
    return 301 https://$host$request_uri;
}

# ==================== Love站点 - HTTPS ====================
server {
    listen 443 ssl http2;
    server_name <your-main-domain>;

    ssl_certificate /etc/letsencrypt/live/<your-main-domain>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<your-main-domain>/privkey.pem;

    root /var/www/love;
    index index.php index.html index.htm;

    client_max_body_size 100m;
    client_body_timeout 180s;

    gzip on;
    gzip_comp_level 5;              
    gzip_min_length 1k;             
    gzip_vary on;
    gzip_buffers 4 8k;
    gzip_http_version 1.1;
    gzip_proxied any;
    gzip_types
        text/plain
        text/css
        text/javascript
        application/javascript
        application/x-javascript
        application/json
        application/xml
        application/xml+rss
        image/svg+xml
        font/woff2
        font/ttf;

    location ~ ^.+?\.php(/.*)?$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        set $path_info $fastcgi_path_info;
        fastcgi_param PATH_INFO $path_info;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

        fastcgi_read_timeout 300;
        fastcgi_send_timeout 300;
        fastcgi_connect_timeout 300;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
}

防IP直连的Nginx配置(选用)

直接给出配置文件新增字段：

# ==================== 防IP访问 - HTTP ====================
server {
    listen 80 default_server;
    listen [::]:80 default_server;
    # 匹配所有未绑定的域名和直接 IP 访问
    # 444直接关闭连接，不返回任何信息，比 403 更安全
    server_name _;
    return 444;
}

# ==================== 防IP访问 - HTTPS ====================
server {
    listen 443 ssl http2 default_server;
    listen [::]:443 ssl http2 default_server;
    server_name _;

    # 配置一个无效或自签名的 SSL 证书，或指向不存在的证书路径
    # 目的是让通过 IP 的 HTTPS 访问因证书错误而失败
    ssl_certificate /data/customSSL/dummy.crt;
    ssl_certificate_key /data/customSSL/dummy.key;

    # 也可以直接返回错误，但证书错误通常能阻止连接建立
    return 444;
}

启用之前，需要先使用openssl申请自签名无效证书：

mkdir -p /data/customSSL
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 \
  -keyout /data/customSSL/dummy.key \
  -out /data/customSSL/dummy.crt \
  -subj "/CN=unused"

LGnewUI-2 杂项处理

路径权限问题

在上文中，PHP 的挂载路径为/var/www/，而docker容器的权限身份一般是uid=33(www-data) gid=33(www-data) groups=33(www-data)，需要保持路径所属身份一致：

# 确认容器权限身份，一般为uid=33(www-data) gid=33(www-data) groups=33(www-data)
docker exec php74-fpm id www-data
# 1. 创建与容器内匹配的用户和组（UID/GID 都是 33）
sudo groupadd -g 33 www-data 2>/dev/null
sudo useradd -u 33 -g 33 -M -s /sbin/nologin www-data 2>/dev/null
# 2. 设置项目目录所有者
sudo chown -R 33:33 /var/www/

MySQL数据库填写

在上文的compose文件中，已经创建了一个数据库：

地址：mysql57
库名：LGnewUI2
用户：root
密码：yourpassword

MySQL数据库备份与恢复

# 备份数据库
docker exec <容器名mysql57> mysqldump -u <用户名root> -p<密码yourpassword> --single-transaction --hex-blob --default-character-set=utf8mb4 --add-drop-table <数据库名LGnewUI2> > ~/backup.sql

# 恢复数据库
docker exec -i <容器名mysql57> mysql -u <用户名root> -p<密码yourpassword> --default-character-set=utf8mb4 <数据库名LGnewUI2> < ~/backup.sql

和风天气API--生成Ed25519密钥对

cd ~
# 生成私钥文件
openssl genpkey -algorithm Ed25519 -out private.pem
# 导出公钥文件
openssl pkey -in private.pem -pubout -out public.pem
# 查看内容
cat private.pem
cat public.pem

获取CDN客户端真实IP

在Nginx配置文件的Server字段中，添加如下配置：

set_real_ip_from 0.0.0.0/0;
real_ip_header X-Forwarded-For;
real_ip_recursive on;

具体功能：

接受来自所有IP的请求(理论上该使用场景只需填写CDN的IP段)
从X-Forwarded-For请求头获取真实IP
递归搜索，从右向左排除所有信任IP段，取第一个不信任IP(当前配置下默认取最左侧第一个IP，通常为CDN自动填写的客户端真实IP)

阿里云ESA(开启HTTP请求头添加后)的默认请求头为ali-real-client-ip，如有开启请替换掉X-Forwarded-For。

敏感目录拒绝访问

在Nginx配置文件的Server字段中，添加如下配置：

# ── 敏感目录 ──
location ^~ /storage/ { return 404; }
location ^~ /config/ { return 404; }
location ^~ /vendor/ { return 404; }
location ^~ /phpmailer/ { return 404; }
location ^~ /cron/ { return 404; }
location ^~ /install/ { return 404; }

# ── 敏感根目录文件 ──
location = /composer.json { return 404; }
location = /readme.txt { return 404; }
location = /config.php { return 404; }

服务器性能优化：添加Swap分区

2G内存没有 Swap 很危险，OOM 时会直接杀进程。

# 创建 2G swap 文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 持久化配置
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# 降低swap使用倾向（优先用物理内存）
echo 'vm.swappiness = 10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

# 验证
free -h

其他工具

DBeaver | 数据库管理(此处可用来转移、备份MySQL)
WinSCP | SFTP工具(上传文件到服务器)
MobaXterm | SSH工具(连接服务器、编辑文件)

通过Docker搭建Minecraft服务器 | MacMini、ArchLinux实战

Wed, 25 Mar 2026 00:00:00 GMT

Docker的安装与配置

在Windows上安装docker

Win+R打开运行窗，输入optionalfeatures打开Windows功能面板，勾选 适用于Linux的Windows子系统 和 虚拟机平台：

来到 DockerDesktop安装文档，选择你的架构，Windows日用机一般为x86_64，你也可以在这里安装 Linux 和 MacOS 的桌面版。

随后在我们要使用docker命令时，需要保持 DockerDesktop 运行中。

Debian系安装docker

# 获取官方脚本
curl -fsSL https://get.docker.com -o install-docker.sh

# 执行安装脚本
sudo sh install-docker.sh

# 启动 Docker 服务
sudo systemctl start docker

阿里云服务器参考教程:

#删除Docker相关源
sudo rm -f /etc/apt/sources.list.d/*docker*.list
#卸载Docker和相关的软件包
for pkg in docker.io docker-buildx-plugin docker-ce-cli docker-ce-rootless-extras docker-compose-plugin docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove -y $pkg; done

#添加 GPG 密钥
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL http://mirrors.cloud.aliyuncs.com/docker-ce/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
#将该软件源添加到 Apt 源列表中。
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: http://mirrors.cloud.aliyuncs.com/docker-ce/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
#安装Docker社区版本，容器运行时containerd.io，以及Docker构建和Compose插件
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

#启动Docker
sudo systemctl start docker
#设置Docker守护进程在系统启动时自动启动
sudo systemctl enable docker

ArchLinux安装docker

# 使用pacman直接安装
sudo pacman -S docker docker-compose

# 启动 Docker 服务
sudo systemctl start docker

MacOS安装docker

# 检查版本
brew --version

# (选)安装Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

# 安装orbstack作为docker的运行平台，再安装docker和compose
brew install --cask orbstack docker docker-compose

orbstack 相关命令(使用docker时保持开启)：

# 开机
orb start

# 状态
orb status

# 下机
orb stop

# 配置docker
orb config docker

docker配置镜像源、开机自启动

# 启用开机自启
sudo systemctl enable docker

# 查看状态
sudo systemctl status docker

# Linux手动配置镜像源
sudo nano /etc/docker/daemon.json

# MacOS基于orbstack配置镜像源
orb config docker

# Windows在文件资源管理器中输入以下地址
%USERPROFILE%\.docker\daemon.json

轩辕镜像一键配置脚本:

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

镜像源配置示例：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live/"
  ]
}

常用的docker命令

  # 查看镜像列表
  docker image ls

  # 拉取镜像
  docker pull <镜像名>

  # 删除镜像
  docker rmi <镜像名>

  # 强制删除
  docker rmi -f <镜像名>

  # 查看运行中的容器
  docker ps

  # 查看所有容器（包括停止的）
  docker ps -a

  # 运行容器
  docker run -d --name <容器名> <镜像名>

  # 停止容器
  docker stop <容器名或ID>

  # 启动容器
  docker start <容器名或ID>

  # 删除容器
  docker rm <容器名或ID>

  # 强制删除运行中的容器
  docker rm -f <容器名或ID>

  # 查看容器日志
  docker logs <容器名>

  # 实时查看日志
  docker logs -f <容器名>

  # 进入容器内部
  docker exec -it <容器名> /bin/bash

  # 启动所有服务
  docker compose up -d

  # 停止所有服务
  docker compose down

  # 查看服务状态
  docker compose ps

  # 查看日志
  docker compose logs -f

  # 重启服务
  docker compose restart

  # 清理所有未使用的镜像
  docker image prune -a

  # 清理未使用的卷
  docker volume prune

  # 打包镜像文件为jar包离线使用
  docker save -o <文件名>.tar <镜像名>

  # 加载离线镜像jar包
  docker load -i <文件名>.tar

minecraft-server镜像

itzg/docker-minecraft-server 是一个提供Minecraft镜像的一个仓库，我们只需根据 minecraft-server文档，选择合适的镜像和配置，即可完成一键启动Minecraft服务器。

根据 Docker-Hub的镜像仓库选择不同Java版本的镜像。本文将以 Minecraft-Paper-1.21.4 和 BetterMCv54-Forge-1.20.1 这两个服务器举例，并分别部署在 ArchLinux 和 MacMini 上，所选用的 Java 版本为 java21，作者还提供了一个用于备份的镜像 mc-backup，这里我选择使用2026.3.2版本。

# 拉取docker镜像(必要时使用sudo)
docker pull itzg/minecraft-server:java21
docker pull itzg/mc-backup:2026.3.2

BetterMCv54的compose配置

在作者的GitHub仓库中，提供了这么一个示例配置：docker-compose-forge-bettermcplus

笔者在此基础上结合docker-mc-backup进行了进一步配置，请确保文件名为docker-compose.yml：

services:

  # 备份预热:启动restore-tar-backup脚本，如果在backups目录中有备份tar包，便对data目录进行覆盖，并在执行后停止。
  restore-backup:
    image: itzg/mc-backup:2026.3.2   # 检查镜像名
    restart: "no"
    entrypoint: restore-tar-backup
    volumes:
      - ./minecraft-data:/data       # 服务器文件
      - ./mc-backups:/backups:ro     # 备份文件夹

  # 服务器本体容器
  mc_bmp:
    image: itzg/minecraft-server:java21-jdk  # 检查镜像名
    container_name: mc_bmp                   # 自定义容器显示名称
    healthcheck:                             # 容器健康检查
      interval: 30s                          # 多久检查一次
      timeout: 60s                           # 单次检查的超时时间
      retries: 10                            # 连续失败多少次算不健康
      start_period: 300s                     # 容器启动后多久才开始检查（等待启动时间）
    ports:
      - 25565:25565                          # 游戏连接端口
      - 2222:2222                            # SSH命令传入端口
    restart: unless-stopped
    environment:
      EULA: "true" 
      ENABLE_SSH: true                       # 开启SSH命令传入
      TYPE: FORGE                            # 游戏类型
      VERSION: 1.20.1                        # 游戏版本
      FORGE_VERSION: 47.4.10                 # Forge版本
      MEMORY: "8G"                           # 内存分配
      GENERIC_PACK: /modpacks/BMC4_Server_Pack_v54.zip   # (整合包)服务器压缩文件位置

      # JVM虚拟机优化参数
      JVM_OPTS: "-server"
      JVM_XX_OPTS: "-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=20 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=16M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:SurvivorRatio=32 -XX:MaxTenuringThreshold=1 -XX:+UseStringDeduplication -XX:+UseCompressedOops -XX:+UseCompressedClassPointers"
      JVM_DD_OPTS: "-Dfml.readTimeout=180 -Dfml.debugRegistryEntries=true -Dfile.encoding=UTF-8"  
      
      TZ: "Asia/Shanghai"                    # 时区
      OVERRIDE_SERVER_PROPERTIES: "false"    # 是否覆盖Server_properties文件
      DIFFICULTY: "normal"                   # 游戏难度
      MAX_TICK_TIME: "-1"                       
      VIEW_DISTANCE: "6"                     # 视距
      ALLOW_FLIGHT: "true"                   # 是否允许飞行
      OPS: "RoL1n_SrP"                       # 管理员
      MAX_PLAYERS: 10                        # 最大玩家数
      PVP: "false"                           # 是否开启PVP
      LEVEL_TYPE: "biomesoplenty"                    
      RCON_PASSWORD: "yourpassword"          # Rcon、SSH共用密码
    volumes:
      - ./modpacks:/modpacks:ro              # 只读(整合包)服务器压缩文件
      - ./minecraft-data:/data               # 服务器游戏数据

    # 仅当备份预热脚本结束后才进行服务器加载
    depends_on:
      restore-backup:
        condition: service_completed_successfully
  
  # 常驻备份容器
  backups:
    image: itzg/mc-backup:2026.3.2           # 检查镜像名
    
    # 仅在 mc_bmp 容器健康运行后才运行此容器
    depends_on:
      mc_bmp:                                # 检查服务器容器名(Services名称)
        condition: service_healthy
    environment:
      BACKUP_INTERVAL: "2h"                  # 每2小时进行一次备份
      PRUNE_BACKUPS_COUNT: 8                 # 最大备份文件数量
      BACKUP_ON_STARTUP: true                # 是否在启动时进行备份
      RCON_HOST: mc_bmp                      # Rcon所连接的(服务器)容器名(Services名称)
      INITIAL_DELAY: 30m                     # 在启动后30min才执行计时/备份
      PAUSE_IF_NO_PLAYERS: false             # 是否在无玩家时暂停计时/备份
      PLAYERS_ONLINE_CHECK_INTERVAL: 5m      # 间隔5分钟检查服务器中是否有玩家
    volumes:
      - ./minecraft-data:/data:ro            # 只读服务器文件数据
      - ./mc-backups:/backups                # 备份文件目录

备份机制是这样的 (备份并不需要关闭服务器):

发送游戏指令save-off，禁用自动保存
执行save-all，将所有数据写入磁盘
对服务器目录进行全量打包，并备份至备份文件夹
发送指令save-on，开启自动保存

此外，betterMC是一款整合包，其他整合包作者也通常会发布 服务端整合包，你需要将GENERIC_PACK: /modpacks/BMC4_Server_Pack_v54.zip中的BMC4_Server_Pack_v54.zip改写为你所使用的服务端整合包名称，并在docker-compose.yml同目录下创建modpacks文件夹，来存放这个服务端整合包，这样docker容器在运行时才能生成正确的服务器文件。

Paper插件服的compose配置

相比于 BetterMC，Paper 的配置会简单不少，因此笔者只对不同部分做注释：

version: "3"
services:
  restore-backup:
    image: itzg/mc-backup:2026.3.2
    restart: "no"
    entrypoint: restore-tar-backup
    volumes:
      - ./minecraft-data:/data
      - ./mc-backups:/backups:ro
      
  mc_paper:                                 # 这里的服务名定义为 mc_paper
    image: itzg/minecraft-server:java21-jdk
    container_name: mc_paper                # 容器名也是 mc_paperr
    ports:
      - "25565:25565"
      - "2222:2222"
    environment:
      EULA: "TRUE"
      ENABLE_SSH: true
      TYPE: "PAPER"                         # 游戏类型为 Paper
      VERSION: "1.21.4"                     # 游戏版本
      VIEW_DISTANCE: 8         
      MEMORY: 4G
      ENABLE_WHITELIST: "FALSE"             # 是否启用白名单
      OPS: "RoL1n_SrP"
      ONLINE_MODE: "TRUE"                   # 是否开启正版验证
      SERVER_NAME: "SrP-Server"             # 服务器名称
      MOTD: "It's provided by RoL1n."       # 服务器列表欢迎语
      ICON: "/icon.png"                     # 这里可以自定义你的服务器图标(容器内路径)
      OVERRIDE_SERVER_PROPERTIES: "FALSE"
      RCON_PASSWORD: "yourpassword"
    tty: true
    stdin_open: true
    restart: unless-stopped
    volumes:
      - ./minecraft-data:/data
      - ./icon.png:/icon.png                # 需要在这里挂载上服务器图标位置(容器 "外->内" 路径映射)
    depends_on:
      restore-backup:
        condition: service_completed_successfully

  backups:
    image: itzg/mc-backup:2026.3.2
    depends_on:
      mc_paper:                             # 注意这里的服务名
        condition: service_healthy
    environment:
      BACKUP_INTERVAL: "2h"
      PRUNE_BACKUPS_COUNT: 8
      BACKUP_ON_STARTUP: true
      RCON_HOST: mc_paper                   # 这里也是服务名
      INITIAL_DELAY: 30m
      PAUSE_IF_NO_PLAYERS: false
      PLAYERS_ONLINE_CHECK_INTERVAL: 5m
    volumes:
      - ./minecraft-data:/data:ro
      - ./mc-backups:/backups

Docker启动与命令通信

当一切准备就绪，就可以使用docker-compose命令来启动服务器了：

# 进入docker-compose.yml所在目录
cd ...

# 启动容器链，并持久化运行(必要时sudo提权)
docker compose up -d

itzg/minecraft-server镜像默认有一个开启在2222端口上的SSH，直接连接到容器内部的游戏服务器，你可以通过ssh命令连接服务器，查看游戏实时日志并发送命令：

# ssh命令标准
ssh <username>@<server_address> -p 2222

# 示例(如果是在本地运行的容器)
ssh root@127.0.0.1 -p 2222
# 输入在compose中的RCON_PASSWORD值(无键盘输入显示，需要盲打)

内网穿透Frp

如果你能够租到10M及以上带宽的云服务器，那么你可以使用自建内网穿透，否则还是直接使用樱花内网穿透服务吧。

在这里我们并不需要下载任何樱花内网穿透的软件，在Windows和Debian系Linux中，完全可以下载原版frp的对应版本，然后配置使用frpc即可，配置文件由隧道列表提供：

手动下载Frp并配置，请参考笔者的往期文章: 内网穿透Frp搭建

Mac中安装frp与配置樱花映射

# 使用brew安装
brew install frpc

# 查看安装位置与验证版本
which frpc
frpc --version

# 编辑配置文件(将获取到的配置粘贴至此)
sudo nano $(brew --prefix)/etc/frp/frpc.toml

# 启动服务
brew services start frpc

# 查看状态
brew services list

ArchLinux中安装frp与配置樱花映射

# 使用pacman安装
sudo pacman -S frpc

# 查看安装位置与验证版本
which frpc
frp --version

# 编辑配置文件
sudo nano /etc/frp/frpc.toml

# 启动服务
systemctl enable frpc
systemctl start frpc

# 查看状态
systemctl status frpc

【重置版】在Windows系统中安装深度学习框架Pytorch与TensorFlow

Thu, 19 Mar 2026 00:00:00 GMT

使用anaconda管理python版本

进入 Anaconda下载地址，这里下载miniconda即可，只是用到conda来管理环境，安装过后添加系统环境变量：

conda相关命令：

# 检查当前的conda环境(默认创建了base环境，搭配了最新版本的Python解释器)
conda env list
# 创建新的conda环境(以python3.11的"pytorch"环境为例)("pytorch"为conda环境名)
conda create -n pytorch python=3.11 -y
# 激活(进入)目标环境"pytorch"
conda activate pytorch
# 检查当前环境中的包、库(会列出通过conda、pip安装的包、库)
conda list
# 删除目标环境("pytorch"为例)
conda env remove -n pytorch

Pytorch-GPU 安装

Pytorch-GPU版需要拥有NVIDIA支持Cuda的显卡，可以用该命令检查是否安装NVIDIA驱动和Cuda版本：nvidia-smi

进入Pytorch快速开始页面，选择 Stable->Windows->Pip->Python->(选择≤你的Cuda版本号)，复制命令。

回到powershell终端，进入创建好的pytorch虚拟环境(conda activate pytorch)，输入命令安装即可(Cuda13为例)：pip install torch torchvision --index-url https://download.pytorch.org/whl/cu130

在Vscode中验证Pytorch-GPU可用性

编辑一个python文件(test.py)，根据VScode提示安装Python拓展包:

import torch
print(torch.cuda.is_available())

按下Ctrl+Shift+P打开命令面板，输入python: select interpreter，选择到conda虚拟环境pytorch中的python3.11解释器。

按下F5，进行调试，或者Ctrl+F5直接运行，将看到如下结果，True即表明Pytorch-GPU安装成功。

TensorFlow-GPU 安装

这里针对Windows Native的NVIDIA显卡版本的TensorFlow，幽默的是，在 TensorFlow的中文安装页面中，提示安装的TensorFlow2是CPU、GPU混合最新版本：pip install --upgrade tensorflow

而TensorFlow对Windows原生NVIDIA显卡支持的GPU版最终版本是TensorFlow2.10, 最新版本在笔者此时已经是2.21了，绝对不可能支持Cuda；但将该页面改为英文指引，却赫然写明了 TensorFlow 2.10 was the last TensorFlow release that supported GPU on native-Windows. 这让不少人踩了坑。

那么我们便按照英文指引来安装tensorflow-gpu版：

创建conda环境：conda create -n tf python=3.9 -y
激活conda环境：conda activate tf
安装cuda和cuDNN：conda install -c conda-forge cudatoolkit=11.2 cudnn=8.1.0
安装TensorFlow：pip install "tensorflow<2.11"
验证CPU配置：python -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"
验证GPU配置：python -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

在验证安装环节，由于tensorflow2.10是使用的numpy1.x，而笔者此时miniconda自带的是numpy2.x，遇到报错，只需要对numpy进行降级：pip install "numpy<2"

下面给出笔者的验证响应，说明笔者已经成功安装：

# CPU配置
tf.Tensor(-1373.9692, shape=(), dtype=float32)
# GPU配置
[PhysicalDevice(name='/physical_device:GPU:0', device_type='GPU')]

笔记本重装Windows系统 | 软件推荐

Tue, 17 Mar 2026 00:00:00 GMT

重装前的准备

笔者使用的是华硕的笔记本电脑，仅以此为例。

将必要的文件进行备份
准备一个8G以上U盘
下载Windows11官方镜像
下载笔记本厂商驱动，以华硕为例，前往下载中心

装机流程

华硕主板需要在BIOS中关闭VMD，防止在系统无法识别磁盘控制器。注:关闭VMD技术将会导致您的电脑无法使用 RAID 磁盘阵列。

使用Ventoy将U盘刷写
将Windows镜像ISO和笔记本厂商驱动等文件copy到刷好的U盘内
插上U盘，进行重启，期间按F2进入BIOS
将U盘设置为第一启动项
若无法进入ventoy的引导界面，请根据官方教程操作，或者直接关闭 Secure Boot，但会影响到反作弊程序的运行。
进入Windows 11系统镜像安装界面后，重点将分区列表清理干净(建议如此)，比如原系统安装在磁盘0,建议提前将磁盘0中的重要文件转移到磁盘1或者其他存储设备中，然后在这里清空所有磁盘0的分区，再选中磁盘0进行装载系统。
等待Windows 11安装系统，直到引导界面出现，这里默认需要插上网线，进行联网驱动更新，但也可以手动选择提前在U盘中准备的厂商驱动。
在进入系统后，依次安装准备好的笔记本厂商提供的驱动程序，随后进行关机重启。

Windows初始化

重新进入系统后，进入 隐私和安全性 -> 设备加密，选择关闭。(这里重装完系统后，趁文件还没有那么多，解密很快)如果你有设备加密的需要，可以选择保持开启，但一定要在激活Windows之后，登录微软账户，因为恢复密钥只有微软官方提供给你。
下载Office Tool Plus，进入程序后，遵照官方给的快速配置教程，点击命令按钮或者按下 Ctrl + Shift + P 打开命令框，输入以下命令，安装office三件套(Word、PPT、Excel)：

deploy /add O365ProPlusRetail_zh-cn /O365ProPlusRetail.exclapps Access,Groove,Lync,OneDrive,OneNote,Outlook,OutlookForWindows,Publisher,Teams /channel Current /dlfirst /edition 64

虽然在 Office Tool Plus 中有使用KMS激活Office的功能，但这里还是推荐使用 MAS 来激活Windows和Office，遵照官网，打开Windows自带的Powershell终端(只需要右键任务栏的Windows图标，然后选择终端打开即可)，输入命令：irm https://get.activated.win | iex 如果网络通畅，即可进入交互式脚本。
进入脚本后，键入1即可使用数字权利激活Windows，跟随提示回到首页，键入2安装Ohook即可激活Office。关于 KMS、HWID、Ohook 的相关信息，可以来到雨月空间站的文章了解。

软件推荐

Steamcommunity 302 | 这是由羽翼城大佬制作的加速工具，可以用来直连GitHub、Steam等一些国外平台。
g-helper | 一款用来代替华硕笔记本奥创中心的软件，主要进行CPU和GPU频率、风扇的调整，比较好用的是独显直连和三种预设切换的丝滑，可以释放出奥创达不到的性能。
everything | 一款强大的检索工具，笔者的日常使用已经脱离不开了，能够极其快速的找到你电脑上的任意一个文件。
Snipaste | 一款简洁好用的截图贴图工具
notepad3 | 一款记事本平替工具，一定程度上还能平替vscode编辑器，提供多种语法的高亮，启动快速，简洁好用。
imageglass | 图片查看器(支持一定的图片编辑)
mpv_PlayKit(原mpv-lazy) | 由mpv爱好者打造的魔改版视频浏览器，主打懒人一键配置，启动速度快，简洁好用。
NanaZip | 基于7Zip的现代化压缩工具，可在微软商店一键下载安装。
Obsidian | 好用的笔记软件
Steam | 官方网址
FDM下载器 | IDM免费平替版，可在微软商店一键下载安装
bluetooth audio receiver | 使用蓝牙技术让PC作为手机的扬声器

将任意视频转换为单通道音频、H.264编码的mp4格式视频 | FFmpeg

Thu, 12 Mar 2026 00:00:00 GMT

脚本说明

这是一个跨平台的视频处理工具，能够一键合并视频中的所有音频轨道并重新编码，特别适合处理录播、视频编辑等场景。

系统要求

依赖软件

FFmpeg
- Windows：首次运行时脚本会自动下载
- Linux：sudo apt install ffmpeg 或 sudo yum install ffmpeg
- macOS：brew install ffmpeg

硬件加速条件

Intel QSV：Intel 4代酷睿及以上集显/独显
AMD AMF：AMD Radeon 及以上显卡
NVIDIA NVENC：GTX 600系列及以上显卡
VideoToolbox：Mac 2013年及以后机型

使用方法

Linux/macOS

# 1. 克隆仓库或下载脚本
git clone https://github.com/RolinShmily/SrP-Scripts.git
cd SrP-Scripts/video-merge-audio-reencode

# 2. 赋予执行权限（首次使用）
chmod +x video-merge-audio-reencode.sh

# 3. 运行脚本
./video-merge-audio-reencode.sh

Windows

:: 1. 克隆仓库或下载脚本
git clone https://github.com/RolinShmily/SrP-Scripts.git
cd SrP-Scripts\video-merge-audio-reencode

:: 2. 双击运行或使用命令行
video-merge-audio-reencode.bat

工作流程

扫描视频文件：递归扫描当前目录下的所有视频文件（支持 mp4、mkv、avi、mov 等常见格式）
检测硬件编码器：自动检测系统可用的硬件编码器，选择最优方案
处理音轨：
- 提取所有音频轨道
- 合并为一个立体声轨道（降混）
重新编码：
- 视频流：使用硬件编码器重新编码为 H.264
- 音频流：重新编码为 AAC
输出文件：在原文件同目录生成 _output.mp4 后缀的新文件

使用示例

基本使用

将脚本放入包含视频文件的目录中运行：

# 当前目录结构：
# ├── video-merge-audio-reencode.sh
# ├── 录播1.mkv
# ├── 录播2.mp4
# └── 子文件夹/
#     └── 录播3.avi

./video-merge-audio-reencode.sh

# 输出：
# ├── 录播1_output.mp4
# ├── 录播2_output.mp4
# └── 子文件夹/
#     └── 录播3_output.mp4

处理单个视频

如果只想处理特定视频，可以将脚本移动到视频所在目录：

# 目录结构：
# ├── 我的视频/
# │   ├── 原始视频.mkv
# │   └── video-merge-audio-reencode.sh

./video-merge-audio-reencode.sh

# 输出：原始视频_output.mp4

Batch脚本内容

@echo off
REM Video Processing Script (Windows)
REM Merge audio tracks and re-encode video to H.264
REM Author: RoL1n
REM License: MIT

setlocal enabledelayedexpansion

cd /d "%~dp0"

echo Starting video processing script...
echo Working directory: %CD%
echo.

REM Check dependencies
echo Checking ffmpeg...

REM Try to find ffmpeg in system PATH
set "FFMPEG_PATH="
where ffmpeg >nul 2>&1
if not errorlevel 1 (
    set "FFMPEG_PATH=ffmpeg"
    goto :ffmpeg_found
)

REM Check local cache directory
set "CACHE_DIR=%USERPROFILE%\.srp-scripts\ffmpeg"
set "LOCAL_FFMPEG=%CACHE_DIR%\ffmpeg.exe"

if exist "%LOCAL_FFMPEG%" (
    set "FFMPEG_PATH=%LOCAL_FFMPEG%"
    goto :ffmpeg_found
)

REM Download ffmpeg automatically
echo ffmpeg not found in system PATH or local cache
echo.
echo [INFO] Downloading ffmpeg automatically...
echo This will only happen once. Future runs will use the cached version.
echo.

REM Create cache directory
if not exist "%CACHE_DIR%" mkdir "%CACHE_DIR%"

REM Download ffmpeg using curl
set "DOWNLOAD_URL=https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.zip"
set "ZIP_FILE=%CACHE_DIR%\ffmpeg.zip"

echo Downloading from: %DOWNLOAD_URL%
echo.

curl -L -o "%ZIP_FILE%" "%DOWNLOAD_URL%"
if errorlevel 1 (
    echo.
    echo [ERROR] Failed to download ffmpeg
    echo Please check your internet connection or download manually:
    echo %DOWNLOAD_URL%
    echo.
    pause
    exit /b 1
)

echo Download completed. Extracting...
echo.

REM Extract zip to a temporary subfolder
set "TEMP_EXTRACT_DIR=%CACHE_DIR%\temp_extract"
if exist "%TEMP_EXTRACT_DIR%" rmdir /s /q "%TEMP_EXTRACT_DIR%"
mkdir "%TEMP_EXTRACT_DIR%"

powershell -Command "Expand-Archive -Path '%ZIP_FILE%' -DestinationPath '%TEMP_EXTRACT_DIR%' -Force"
if errorlevel 1 (
    echo.
    echo [ERROR] Failed to extract zip file
    del "%ZIP_FILE%"
    rmdir /s /q "%TEMP_EXTRACT_DIR%"
    pause
    exit /b 1
)

REM Find and move ffmpeg binaries from subfolder
REM gyan.dev ffmpeg structure: ffmpeg-X.X.X-essentials_build/bin/*.exe
for /d %%D in ("%TEMP_EXTRACT_DIR%\*") do (
    echo Found ffmpeg folder: %%~nxD
    if exist "%%D\bin\ffmpeg.exe" (
        echo Found ffmpeg.exe in bin subfolder
        move /Y "%%D\bin\*.exe" "%CACHE_DIR%\" >nul
        move /Y "%%D\bin\*.dll" "%CACHE_DIR%\" >nul
    ) else (
        echo Found ffmpeg.exe in root folder
        move /Y "%%D\*.exe" "%CACHE_DIR%\" >nul
        move /Y "%%D\*.dll" "%CACHE_DIR%\" >nul
    )
)

REM Cleanup
del "%ZIP_FILE%" 2>nul
rmdir /s /q "%TEMP_EXTRACT_DIR%" 2>nul

REM Verify extraction
if not exist "%LOCAL_FFMPEG%" (
    echo.
    echo [ERROR] Failed to extract ffmpeg
    echo ffmpeg.exe not found at: %LOCAL_FFMPEG%
    echo.
    echo Contents of cache directory:
    dir /b "%CACHE_DIR%"
    echo.
    pause
    exit /b 1
)

echo ffmpeg installed successfully to: %CACHE_DIR%
echo.
echo [INFO] Verifying ffmpeg...
"%LOCAL_FFMPEG%" -version | findstr "ffmpeg version"
echo.
echo [INFO] You can delete this cache anytime to reclaim space:
echo   %CACHE_DIR%
echo.

:ffmpeg_found
echo [OK] ffmpeg found
echo [INFO] Using ffmpeg at: %FFMPEG_PATH%
echo.

REM Set ffprobe path based on ffmpeg location
set "FFPROBE_PATH="
if "%FFMPEG_PATH%"=="ffmpeg" (
    set "FFPROBE_PATH=ffprobe"
) else (
    set "FFPROBE_PATH=%FFMPEG_PATH:\ffmpeg.exe=\ffprobe.exe%"
)

REM Verify ffprobe exists
if not "%FFPROBE_PATH%"=="ffprobe" (
    if not exist "%FFPROBE_PATH%" (
        echo [WARN] ffprobe not found at: %FFPROBE_PATH%
        echo [INFO] Will try to use ffprobe from PATH
        set "FFPROBE_PATH=ffprobe"
    )
)

echo [INFO] Using ffprobe at: %FFPROBE_PATH%
echo.

REM Create output directory
if not exist "output" mkdir "output"

REM Find video files
echo Scanning for video files...

set COUNT=0
for %%F in (*.mkv *.mov *.mp4) do set /a COUNT+=1

for /d %%D in (*) do (
    if /i not "%%D"=="output" (
        for %%F in ("%%D\*.mkv" "%%D\*.mov" "%%D\*.mp4") do (
            if exist "%%F" set /a COUNT+=1
        )
    )
)

echo Found %COUNT% video file(s)
echo.

if %COUNT%==0 (
    echo [ERROR] No video files found
    pause
    exit /b 1
)

REM Detect encoder
set "HW_ENCODER=libx264"
echo Detecting encoder...

"%FFMPEG_PATH%" -hide_banner -encoders 2>nul | findstr /C:"h264_nvenc" >nul
if !errorlevel! equ 0 (
    set "HW_ENCODER=h264_nvenc"
    echo   Using: NVIDIA NVENC
)

if "!HW_ENCODER!"=="libx264" (
    "%FFMPEG_PATH%" -hide_banner -encoders 2>nul | findstr /C:"h264_amf" >nul
    if !errorlevel! equ 0 (
        set "HW_ENCODER=h264_amf"
        echo   Using: AMD AMF
    )
)

if "!HW_ENCODER!"=="libx264" (
    "%FFMPEG_PATH%" -hide_banner -encoders 2>nul | findstr /C:"h264_qsv" >nul
    if !errorlevel! equ 0 (
        set "HW_ENCODER=h264_qsv"
        echo   Using: Intel Quick Sync
    )
)

if "!HW_ENCODER!"=="libx264" echo   Using: CPU (libx264)
echo.

REM Process videos in current directory
set SUCCESS=0
set FAIL=0

for %%F in (*.mkv *.mov *.mp4) do (
    set "INPUT_FILE=%%F"
    set "FILENAME=%%~nxF"
    set "OUTPUT_FILE=output\%%~nF.mp4"

    echo [INFO] Processing: !FILENAME!

    REM Get audio count
    "%FFPROBE_PATH%" -v error -select_streams a -show_entries stream=codec_type -of csv=p=0 "!INPUT_FILE!" 2>nul > "%TEMP%\audio_tmp.txt"
    for /f %%A in ('type "%TEMP%\audio_tmp.txt" ^| find /c /v ""') do set AUDIO_COUNT=%%A
    del "%TEMP%\audio_tmp.txt" 2>nul
    echo   Audio tracks: !AUDIO_COUNT!

    REM Get bitrate
    "%FFPROBE_PATH%" -v error -select_streams v:0 -show_entries stream=bit_rate -of default=noprint_wrappers=1:nokey=1 "!INPUT_FILE!" 2>nul > "%TEMP%\bitrate_tmp.txt"
    set /p SOURCE_BITRATE=<"%TEMP%\bitrate_tmp.txt"
    del "%TEMP%\bitrate_tmp.txt" 2>nul
    if "!SOURCE_BITRATE!"=="" set SOURCE_BITRATE=0

    REM Calculate target bitrate
    set TARGET_BITRATE=0
    if !SOURCE_BITRATE! GTR 0 (
        set /a TARGET_BITRATE=!SOURCE_BITRATE!/1000
        echo   Source bitrate: !TARGET_BITRATE! kbps
    )

    REM Build encoding parameters
    set CRF_VALUE=23
    if !TARGET_BITRATE! GTR 0 (
        if !TARGET_BITRATE! LSS 2000 set CRF_VALUE=20
    )

    REM Set video params based on encoder
    if "!HW_ENCODER!"=="h264_nvenc" (
        REM Use simple NVENC params for compatibility with older ffmpeg
        if !TARGET_BITRATE! GTR 0 (
            set "VIDEO_PARAMS=-c:v h264_nvenc -preset fast -cq !CRF_VALUE! -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k"
        ) else (
            set "VIDEO_PARAMS=-c:v h264_nvenc -preset fast -cq !CRF_VALUE!"
        )
    ) else if "!HW_ENCODER!"=="h264_amf" (
        if !TARGET_BITRATE! GTR 0 (
            set /a BUF_SIZE=!TARGET_BITRATE!*2
            set "VIDEO_PARAMS=-c:v h264_amf -quality speed -rc vbr -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k -bufsize !BUF_SIZE!k"
        ) else (
            set "VIDEO_PARAMS=-c:v h264_amf -quality speed -rc vbr"
        )
    ) else if "!HW_ENCODER!"=="h264_qsv" (
        if !TARGET_BITRATE! GTR 0 (
            set /a BUF_SIZE=!TARGET_BITRATE!*2
            set "VIDEO_PARAMS=-c:v h264_qsv -preset medium -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k -bufsize !BUF_SIZE!k -global_quality !CRF_VALUE!"
        ) else (
            set "VIDEO_PARAMS=-c:v h264_qsv -preset medium -global_quality !CRF_VALUE!"
        )
    ) else (
        if !TARGET_BITRATE! GEQ 2000 (
            set /a BUF_SIZE=!TARGET_BITRATE!*2
            set "VIDEO_PARAMS=-c:v libx264 -preset medium -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k -bufsize !BUF_SIZE!k"
        ) else (
            set "VIDEO_PARAMS=-c:v libx264 -preset medium -crf !CRF_VALUE!"
        )
    )

    set "AUDIO_PARAMS=-c:a aac -b:a 192k -ac 2"

    echo   Encoding...

    REM Execute ffmpeg with output visible for debugging
    if !AUDIO_COUNT! GTR 1 (
        "%FFMPEG_PATH%" -i "!INPUT_FILE!" -filter_complex "amix=inputs=!AUDIO_COUNT!:duration=longest[a]" -map 0:v -map "[a]" !VIDEO_PARAMS! !AUDIO_PARAMS! -movflags +faststart -y "!OUTPUT_FILE!"
    ) else (
        "%FFMPEG_PATH%" -i "!INPUT_FILE!" !VIDEO_PARAMS! !AUDIO_PARAMS! -movflags +faststart -y "!OUTPUT_FILE!"
    )

    REM Check output
    if exist "!OUTPUT_FILE!" (
        for %%S in ("!OUTPUT_FILE!") do set FILE_SIZE=%%~zS
        if !FILE_SIZE! GTR 0 (
            echo   Done
            set /a SUCCESS+=1
        ) else (
            echo   Failed: Output file is empty
            set /a FAIL+=1
        )
    ) else (
        echo   Failed: Output file not created
        set /a FAIL+=1
    )
    echo.
)

REM Process subdirectories (excluding output)
for /d %%D in (*) do (
    if /i not "%%D"=="output" (
        pushd "%%D"
        for %%F in (*.mkv *.mov *.mp4) do (
            set "INPUT_FILE=%%F"
            set "FILENAME=%%~nxF"
            set "OUTPUT_FILE=..\output\%%~nF.mp4"

            echo [INFO] Processing: %%D\!FILENAME!

            REM Get audio count
            "%FFPROBE_PATH%" -v error -select_streams a -show_entries stream=codec_type -of csv=p=0 "!INPUT_FILE!" 2>nul > "%TEMP%\audio_tmp.txt"
            for /f %%A in ('type "%TEMP%\audio_tmp.txt" ^| find /c /v ""') do set AUDIO_COUNT=%%A
            del "%TEMP%\audio_tmp.txt" 2>nul
            echo   Audio tracks: !AUDIO_COUNT!

            REM Get bitrate
            "%FFPROBE_PATH%" -v error -select_streams v:0 -show_entries stream=bit_rate -of default=noprint_wrappers=1:nokey=1 "!INPUT_FILE!" 2>nul > "%TEMP%\bitrate_tmp.txt"
            set /p SOURCE_BITRATE=<"%TEMP%\bitrate_tmp.txt"
            del "%TEMP%\bitrate_tmp.txt" 2>nul
            if "!SOURCE_BITRATE!"=="" set SOURCE_BITRATE=0

            REM Calculate target bitrate
            set TARGET_BITRATE=0
            if !SOURCE_BITRATE! GTR 0 (
                set /a TARGET_BITRATE=!SOURCE_BITRATE!/1000
                echo   Source bitrate: !TARGET_BITRATE! kbps
            )

            REM Build encoding parameters
            set CRF_VALUE=23
            if !TARGET_BITRATE! GTR 0 (
                if !TARGET_BITRATE! LSS 2000 set CRF_VALUE=20
            )

            REM Set video params based on encoder
            if "!HW_ENCODER!"=="h264_nvenc" (
                if !TARGET_BITRATE! GTR 0 (
                    set /a BUF_SIZE=!TARGET_BITRATE!*2
                    set "VIDEO_PARAMS=-c:v h264_nvenc -preset p4 -rc vbr -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k -bufsize !BUF_SIZE!k -cq !CRF_VALUE!"
                ) else (
                    set "VIDEO_PARAMS=-c:v h264_nvenc -preset p4 -rc vbr -cq !CRF_VALUE!"
                )
            ) else if "!HW_ENCODER!"=="h264_amf" (
                if !TARGET_BITRATE! GTR 0 (
                    set /a BUF_SIZE=!TARGET_BITRATE!*2
                    set "VIDEO_PARAMS=-c:v h264_amf -quality speed -rc vbr -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k -bufsize !BUF_SIZE!k"
                ) else (
                    set "VIDEO_PARAMS=-c:v h264_amf -quality speed -rc vbr"
                )
            ) else if "!HW_ENCODER!"=="h264_qsv" (
                if !TARGET_BITRATE! GTR 0 (
                    set /a BUF_SIZE=!TARGET_BITRATE!*2
                    set "VIDEO_PARAMS=-c:v h264_qsv -preset medium -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k -bufsize !BUF_SIZE!k -global_quality !CRF_VALUE!"
                ) else (
                    set "VIDEO_PARAMS=-c:v h264_qsv -preset medium -global_quality !CRF_VALUE!"
                )
            ) else (
                if !TARGET_BITRATE! GEQ 2000 (
                    set /a BUF_SIZE=!TARGET_BITRATE!*2
                    set "VIDEO_PARAMS=-c:v libx264 -preset medium -b:v !TARGET_BITRATE!k -maxrate !TARGET_BITRATE!k -bufsize !BUF_SIZE!k"
                ) else (
                    set "VIDEO_PARAMS=-c:v libx264 -preset medium -crf !CRF_VALUE!"
                )
            )

            set "AUDIO_PARAMS=-c:a aac -b:a 192k -ac 2"

            echo   Encoding...

            REM Execute ffmpeg
            if !AUDIO_COUNT! GTR 1 (
                "%FFMPEG_PATH%" -i "!INPUT_FILE!" -filter_complex "amix=inputs=!AUDIO_COUNT!:duration=longest[a]" -map 0:v -map "[a]" !VIDEO_PARAMS! !AUDIO_PARAMS! -movflags +faststart -y "!OUTPUT_FILE!"
            ) else (
                "%FFMPEG_PATH%" -i "!INPUT_FILE!" !VIDEO_PARAMS! !AUDIO_PARAMS! -movflags +faststart -y "!OUTPUT_FILE!"
            )

            REM Check output
            if exist "!OUTPUT_FILE!" (
                for %%S in ("!OUTPUT_FILE!") do set FILE_SIZE=%%~zS
                if !FILE_SIZE! GTR 0 (
                    echo   Done
                    set /a SUCCESS+=1
                ) else (
                    echo   Failed: Output file is empty
                    set /a FAIL+=1
                )
            ) else (
                echo   Failed: Output file not created
                set /a FAIL+=1
            )
            echo.
        )
        popd
    )
)

echo ===================================
echo Processing completed!
echo   Success: %SUCCESS%
echo   Failed: %FAIL%
echo   Total: %COUNT%
echo ===================================
echo.
endlocal
pause

个人脚本仓库

::github{repo="RolinShmily/SrP-Scripts"}

这个脚本是我根据实际需求开发的，主要用于处理录播文件的音轨合并和格式统一。如果觉得有用，欢迎给个 Star！如果有问题或建议，欢迎提 Issue 或 PR。

SrP-IMG | 零成本随机图片API与现代化画廊

Wed, 11 Mar 2026 00:00:00 GMT

目录结构

├── oriImg/           # [核心] 原始素材目录
│   ├── h/            # 横屏图片素材（强转为 .jpg）
│   ├── v/            # 竖屏图片素材（强转为 .jpg）
│   └── gif/          # 自定义分类（自动保留 .gif 后缀）
├── public/           # 构建产物目录（存放生成的十六进制图片和元数据）
│   ├── h/、v/、gif/   # 映射后的图片集合
│   └── counts.json   # 自动生成的全站索引文件
├── functions/        # Cloudflare Pages Functions
│   └── pic.js        # 由脚本生成的服务端重定向接口
├── components/       # Next.js 组件
│   └── image-gallery.tsx # 核心画廊组件（映射表逻辑）
├── gen_img.py        # 构建大脑：处理图片命名、后缀识别及生成元数据
├── index.js          # Cloudflare Workers 入口
└── README.md

部署指南

1. 素材准备

在根目录 oriImg/ 下创建分类文件夹。

API 专用：创建 h 和 v 目录，放入横/竖屏图片（这些图片在输出时会固定为 .jpg 以兼容所有 API 客户端）
自定义分类：创建如 gif、anime 等目录。脚本会自动取该目录第一张图片的后缀作为该分类的输出后缀

3. Cloudflare Pages/Workers 生产构建

在 Cloudflare Pages 仪表板配置如下：

框架预设：Next.js
构建命令：

python3 gen_img.py --hash-length 2 && npm run build

输出目录：out
环境变量：确保 Python 环境为 3.8+

如果使用 Cloudflare Workers，则需要配置根目录的 wrangler.jsonc：

{
  "name": "srp-img-worker",
  "main": "index.js",
  "compatibility_date": "2026-01-05",
  "compatibility_flags": ["nodejs_compat"],
  "assets": {
    "directory": "./out",
    "binding": "ASSETS"
  }
}

注意：请将 name 改为你要部署的Worker名称；将 compatibility_date 改为你的部署日期。

部署命令：npx wrangler deploy

使用方式

演示地址：https://eo-img.srprolin.top 仅支持A、B方式。

方式 A：服务端 API (JS 重定向)

由生成的 functions/pic.js / index.js 提供支持，适合在 Markdown 或其他网页中直接引用。

功能描述	调用地址	返回结果
随机横图	`/pic?img=h`	302 重定向至 `/h/xxx.jpg`
随机竖图	`/pic?img=v`	302 重定向至 `/v/xxx.jpg`
UA 自动选择	`/pic?img=ua`	手机返回竖图，电脑返回横图

方式 B：前端可视化画廊

访问部署后的根域名（如 https://your-domain.pages.dev）：

自动适配：顶部导航会自动切换 h、v 或 gif 模式
瀑布流展示：基于 Next.js 的高性能瀑布流加载
沉浸式预览：集成 Fancybox，支持放大、旋转、全屏及下载

方式 C：URL 重写 (无感随机)

需在 Cloudflare 仪表板手动配置 Transform Rules：

请将下列表达式与 <your-domain> 换成你的域名

URL重写规则一：

匹配表达式：

(http.host eq "<your-domain>" and starts_with(http.request.uri.path, "/h") and not ends_with(http.request.uri.path, ".jpg")) or (http.host eq "<your-domain>" and starts_with(http.request.uri.path, "/v") and not ends_with(http.request.uri.path, ".jpg"))

路径重写至：

concat(http.request.uri.path, "/", substring(uuidv4(cf.random_seed), 0, 2), ".jpg")

URL重写规则二：

匹配表达式：

(http.host eq "<your-domain>" and starts_with(http.request.uri.path, "/gif") and not ends_with(http.request.uri.path, ".gif"))

路径重写至：

concat(http.request.uri.path, "/", substring(uuidv4(cf.random_seed), 0, 2), ".gif")

注意：如果你的构建命令中 --hash-length 值为 3，那么这里 cf.random_seed 的随机范围右边边界也要从 2 改为 3。

URL访问示例：https://your-domain.pages.dev/h

关于 `gen_img.py`

脚本执行时会进行以下操作：

哈希扩散：通过 --hash-length 指定随机空间。若设为 3，每个分类会生成 $16^3$ 个访问路径
后缀策略：
- 检查 oriImg 下每个子目录
- 若目录名为 h 或 v，输出后缀强制遵循命令行参数（默认 .jpg）
- 否则，自动探测该目录首张图片后缀
元数据导出：生成 counts.json，记录每个分类的图片总数 (counts) 和对应后缀 (category_exts)

安装Archlinux+ClaudeCode，PVE小主机焕发第二春

Sun, 08 Mar 2026 00:00:00 GMT

PVE创建ArchLinux虚拟机

以下过程，继承自上篇文章 PVE虚拟系统与OpenWrt配置安装好的PVE9.1

首先需要安装一个ArchLinux的镜像ISO文件，下面提供清华大学开源软件镜像站的下载地址:

点击下载最新版 ArchLinux-x86_64.iso

接下来我们遵循 ArchLinux简明指南的手动安装教程，因此在虚拟机选择阶段，使用UEFI启动模式：

项目	子列表	说明
常规	名称	ArchLinux
操作系统	-	选择你的ISO镜像文件
系统	机型	q35
系统	BIOS	UEFI
系统	UEFI存储	local-lvm
系统	-	请不要勾选预签名
磁盘	-	按需分配大小
CPU	核心	4
CPU	类别	host
CPU	内存	8192MB
网络	-	默认网桥vmbr0

ArchLinux手动安装

启动后，点击控制台，这时就可以一边看着 ArchLinux简明指南-archlinux基础安装，一边对着控制台操作了。

在进行到 7. 分区和格式化（使用 Btrfs 文件系统）时，我们要先做一步分区前的设置(在指南中也有提到)，具体就是要将虚拟机的磁盘变更为gpt类型，两边结合即可正确完成分区操作。

随后，需要进行一些桌面环境安装前的基础配置，参考 Archlinux简明指南-桌面环境与常用应用安装，进行一步步操作。

在进行到 4. 安装 KDE Plasma 桌面环境时，跳过该桌面环境，先配置一下非root账户的默认编辑器，并安装yay以便于安装AUR中的软件:

# 使用 `vim` 编辑 `~/bashrc` 文件
vim ~/.bashrc
# 在适当位置加入以下内容
export EDITOR='vim'
# cn 源中的签名（archlinuxcn-keyring 在 archlinuxcn）
sudo pacman -S archlinuxcn-keyring
# yay 命令可以让用户安装 AUR 中的软件（yay 在 archlinuxcn）
sudo pacman -S yay

桌面环境推荐使用 Shorin-kiwata大佬准备的Niri桌面环境一键安装脚本，因为该桌面环境的内存占用比较低，对于虚拟机寸土寸金的内存来说，尽量少的内存占用是必要的。

在大佬的Wiki中给的脚本命令是 curl -L shorin.xyz/archsetup | bash ，这里的shorin.xyz/archsetup其实是一个重定向短链，其实际指向文件为 shorin-arch-setup仓库中的strap.sh 。

如果你遇到了网络问题，可以使用透明代理，或者直接将 strap.sh 上传到Arch虚拟机来执行。

启动脚本后，一切配置默认即可，等待完成后，就可以进入到 Shorin's Niri 桌面了，我将带头前往Github给大佬点个Star！

这里是大佬脚本中所安装的软件列表：

# --- 系统基础 ---

# --- 文件系统与快照 (Btrfs/Snapper) ---
snapper                           # Btrfs 快照管理工具
btrfs-assistant                   # Btrfs 图形化管理 (依赖 snapper)
grub-btrfs                        # GRUB 菜单集成快照引导
inotify-tools                     # 监控文件变动 (grub-btrfsd 自动更新需要)
dosfstools                        # FAT 文件系统支持
ntfs-3g                           # NTFS 读写支持
exfat-utils                       # exFAT 支持
f2fs-tools                        # F2FS 支持
udftools                          # 光盘格式支持
xfsprogs                          # XFS 支持
gnome-disk-utility                # 磁盘管理 GUI (Disks)
baobab                            # 磁盘占用分析器

# --- 音频核心 (Pipewire Stack) ---
pipewire                          # 核心音频/视频引擎
lib32-pipewire                    # 32位兼容库 (Steam 必须)
wireplumber                       # 会话管理器
pipewire-pulse                    # PulseAudio 兼容层
pipewire-alsa                     # ALSA 兼容层
pipewire-jack                     # JACK 兼容层
pavucontrol                       # 音量控制面板
sof-firmware                      # 声卡固件 (Sound Open Firmware)
alsa-ucm-conf                     # ALSA 音频路由配置
alsa-firmware                     # 额外声卡固件

# --- 输入法与字体 (Input & Fonts) ---
fcitx5-im                         # Fcitx5 框架元包
fcitx5-chinese-addons             # 中文扩展 (拼音/云拼音)
fcitx5-rime                       # Rime 引擎
rime-ice-git                      # (AUR) 雾凇拼音配置
fcitx5-mozc                       # 日语输入法
adobe-source-han-serif-cn-fonts   # 思源宋体
adobe-source-han-sans-cn-fonts    # 思源黑体
ttf-liberation                    # 红帽基础英文字体
noto-fonts-emoji                  # Emoji 支持
ttf-jetbrains-mono-nerd           # 编程字体 (带图标)
terminus-font                     # TTY 点阵字体

# --- 硬件与电源 (Hardware) ---
power-profiles-daemon             # 电源模式切换 (省电/平衡)
bluez                             # 蓝牙协议栈
bluetui                           # 蓝牙 TUI 管理工具
usbutils                          # lsusb 工具
pciutils                          # lspci 工具
brightnessctl                     # 屏幕亮度控制
lact                              # 显卡控制中心 (A卡/N卡超频监控)
ddcutil-service                   # (AUR) 外接显示器亮度控制服务
iwd                               # networkmanager的网络后端
impala                            # iwd的tui
# --- 基础包管理 ---
flatpak                           # Flatpak 支持
pacman-contrib                    # Pacman 辅助脚本
gvim                              # 系统默认编辑器 (含 vim)
less                              # 分页查看器

# --- Shorin's Niri 依赖 ---

# --- Niri 核心组件 ---
xwayland-satellite                # Niri 必装：XWayland 兼容守护进程
swayidle                          # 空闲管理 (自动锁屏/息屏)
hyprlock                          # 锁屏工具 (支持炫酷特效)
swayosd                           # 屏幕 OSD (音量/亮度弹窗)
wlsunset                          # 护眼模式 (色温调节)
wlogout                           # (AUR) 注销/关机/重启菜单

# --- 状态栏与壁纸 ---
waybar                            # 状态栏
waybar-niri-taskbar-git           # (AUR) Waybar 专用 Niri 任务栏模块
swww                              # 动态壁纸守护进程
waypaper                          # (AUR) 壁纸设置 GUI (swww 前端)
waifu2x-ncnn-vulkan               # 图片超分工具 (优化壁纸画质)

# --- 截图与录屏 ---
grim                              # 截图后端
slurp                             # 屏幕选区工具
swappy                            # 截图快速编辑
satty                             # 现代化截图标注工具
wf-recorder                       # 屏幕录制
hyprpicker                        # 屏幕取色器

# --- 剪贴板管理 ---
wl-clipboard                      # Wayland 剪贴板命令
cliphist                          # 剪贴板历史记录
xclip                             # X11 剪贴板兼容
clipnotify                        # X11 剪贴板通知兼容

# --- 外观与主题 (Theming) ---
nwg-look                          # GTK3 主题配置
matugen                           # (AUR) Material You 动态主题生成
gnome-font-viewer                 # 字体预览

# --- 命令行增强 (Shell & CLI) ---
fish                              # 交互式 Shell
starship                          # 终端提示符
fastfetch                         # 系统信息展示
btop                              # 终端任务管理器
yazi                              # 终端文件管理器 (TUI)
eza                               # ls 替代品
zoxide                            # cd 替代品 (智能跳转)
bat                               # cat 替代品 (语法高亮)
jq                                # JSON 处理
imagemagick                       # 图片处理工具集
ffmpegthumbnailer                 # 视频缩略图生成
chafa                             # 终端图片预览后端
timg                              # 终端图片查看器

# --- 常用软件 ---

# --- 互联网与社交 ---
firefox                           # 火狐浏览器
python-pywalfox                   # (AUR) Firefox 随系统变色
linuxqq-appimage                  # (AUR) QQ
wechat-appimage                   # (AUR) 微信
flclash-bin                       # (AUR) 网络代理工具
localsend                         # 局域网传输神器
nm-connection-editor              # 高级网络连接管理
transmission-gtk                  # BT 下载
video-downloader                  # (AUR) 视频下载器 (B站/油管)

# --- 游戏 (Gaming) ---
steam                             # 游戏平台
lutris                            # 综合游戏库管理
heroic-games-launcher-bin         # Epic/GOG 启动器
protonplus                        # Proton 版本管理
mangohud                          # 游戏性能监控浮层
mangojuice-bin                    # (AUR) Mangohud 配置 GUI
gamescope                         # 游戏窗口合成器
lsfg-vk-bin                       # (AUR) 游戏补帧工具 (LSFG)

# --- 生产力与多媒体 ---
visual-studio-code-bin            # (AUR) VS Code 代码编辑器
typora-free                       # Markdown 编辑器
mpv                               # 视频播放器
imv                               # 图片查看器
obs-studio                        # 推流与录屏
cava                              # 音频可视化频谱
upscaler                          # 图片无损放大 GUI
mission-center                    # 系统监视器 (Win11 风格)
gnome-calendar                    # 日历
gnome-clocks                      # 时钟
virt-manager                      # KVM 虚拟机管理
wine                              # 运行 Windows 程序

# --- Flatpak 应用 ---
# (建议使用 flatpak install 安装，而非 pacman)
# it.mijorus.gearlever            # AppImage 管理器
# io.github.fabrialberio.pinapp   # 网页转本地应用 (PinApp)
# com.github.wwmm.easyeffects     # 系统级音频特效 (降噪/均衡器)
# com.github.tchx84.Flatseal      # Flatpak 权限管理

PVE核显直通

这里以 Intel-N100 芯片为例.

先去往archlinux虚拟机(要接管核显的系统)，安装intel显卡驱动：

sudo pacman -S mesa lib32-mesa vulkan-intel lib32-vulkan-intel

再前往PVE的后台，进入Shell控制台，输入以下命令，屏蔽intel核显，以防止pve率先使用核显:

# 使用nano编辑器，`Ctrl+x`保存修改，`y`确认，再按`enter`保存文件名
nano /etc/modprobe.d/pve-blacklist.conf
# 打开黑名单，添加如下内容
blacklist i915
blacklist snd_hda_intel
# 保存退出后，执行命令
update-initramfs -u -k all

为了让核显完美地被archlinux虚拟机调用，需要下载对应的核显ROM，这里给到github上已有的项目：

intel-igpu-passthru

复制好对应的核显ROM下载地址，然后回到PVE的Shell，进行导入(使用wget方式)：

# 进入kvm目录
cd /usr/share/kvm/
# wget下载对应rom
wget https://github.com/LongQT-sea/intel-igpu-passthru/releases/download/v0.1/ADL-N_TWL_GOPv21_igd.rom

通过命令行方式编辑虚拟机硬件，这里我的archlinux虚拟机编号为101，因此我需要编辑101.conf：

# 编辑虚拟机配置文件
nano /etc/pve/qemu-server/101.conf
# 在文件首行添加如下内容
args: -set device.hostpci0.bus=pci.0 -set device.hostpci0.addr=2.0 -set device.hostpci0.x-igd-opregion=on
# 在文件末尾添加PCI设备(UHD核显+板载声卡)(注意修改rom文件名)
hostpci0: 0000:00:02.0,romfile=ADL-N_TWL_GOPv21_igd.rom
hostpci1: 0000:00:1f.3

回到PVE的archlinux虚拟机硬件，查看声卡IMMUO是否与其他要用的设备冲突，判断是否取消直通声卡，同理，也可以在这里直通USB控制器，以便于连接键鼠。

最后，先关闭所有虚拟机，再重启PVE系统，连接好显示设备，启动Archlinux虚拟机，就可以看到登录界面了！

ClaudeCode AI CLI

以我刚刚配置好的archlinux为例。

这里推荐使用 ZCF - Zero-Config Code Flow 工具，一键配置ClaudeCode。

首先确保机器环境中安装了Node.js：

# 检查版本
node -v
npm -v
npx -v

若没有，请到 Node.js 官网安装node(这里给到默认安装命令)：

# 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 代替重启 shell
\. "$HOME/.nvm/nvm.sh"

# 下载并安装 Node.js：
nvm install 24

# 验证 Node.js 版本：
node -v # Should print "v24.14.0".

# 验证 npm 版本：
npm -v # Should print "11.9.0".

如果你是Windows系统，我们需要在终端中输入Set-ExecutionPolicy RemoteSigned，以便于npm被系统正常识别。

打开终端(Shorin's Niri默认快捷键Super+T)：

# 切换为bash环境(Shorin's Niri默认使用了fish，提供非常友好的命令补全，但不兼容bash)
bash
# 一键应用zcf
npx zcf init

随后就是跟着配置即可，在API配置中可以选择 稍后进行，下面将介绍如何接入 GLM Coding Plan。

GLM Coding Plan接入

先到API Key中申请一个apikey并复制保存。

接下来，打开终端，输入以下命令接入：

# 切换到bash
bash
# 自动化脚本
curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh
# 根据提示，输入提前准备好的apikey即可

PVE虚拟系统与OpenWrt配置

Sat, 07 Mar 2026 00:00:00 GMT

PVE9.1的安装

进入 Proxmox VE 虚拟环境系统官方下载页，下载 Proxmox VE 9.1 ISO Installer 。

进入 balenaEther 写盘工具官网，下载写盘工具，并准备一个不用的 U盘，存储 16G 左右。

下载完成后，将 U盘插入个人PC中，打开 balenaEther 软件，选择 PVE9.1的ISO镜像文件，选择存储对象为 U盘，执行烧录。

请确保N100具有至少一块硬盘设备，用于安装PVE系统本体。

将刷好ISO的U盘插入 N100 小主机，再连接显示设备 (HDMI/DP) 和鼠标、键盘 (USB) 以及将网口1 (RJ45)连接至PC，然后启动 N100 小主机，在屏幕点亮时，疯狂点按 Delete 键，进入主板 BIOS。

开启主板CPU核芯显卡的 VT-d 模式、初始化iGPU 和 大于4G空间地址解码。

进入BIOS启动项，将已插入的 U盘设备设置为 第一启动项，保存并退出BIOS，进行自动重启。

PVE界面安装向导

默认第一项，使用图形化安装方式，接下来依次是：

接收用户协议
选择安装硬盘
选择国家、时区
输入密码、邮箱

这里的第一项是选择管理网口，我们在启动小主机之前，已经将网口1(这里显示为绿色nic0)连接至PC，那么网口1就作为了PVE的管理网口。随后设置 hostname，可以设置为 pve.local.

我们独立设置一个网段用于All in One设备：

IP Address(PVE的IP地址):192.168.22.111
Gateway(网关):192.168.22.1
DNS(阿里云):223.5.5.5

随后等待安装成功，然后 拔掉U盘，再点击 reboot 重启PVE。

等再次出现界面，就会有提示，Web管理页URL为：http://192.168.22.111:8006。

随后在PC的网络设置中，手动设置PC的IP处于和PVE同一网段：

这样设置后，便可在PC浏览器通过http://192.168.22.111:8006访问PVE后台，默认用户名为 root。

OpenWrt软路由系统安装

首先，OpenWrt官网中的系统镜像是非常纯净的，一些拓展包并没有直接放在系统镜像中，所以这里更推荐去恩山无线论坛中寻找社区已经打包好的系统。

这里给到我所使用的一个OpenWrt镜像：

LsymOS: openwrt-x86-64-generic-squashfs-combined-efi.img

下载img镜像文件后，上传至PVE系统。

随后，点击 创建虚拟机 ，注意虚拟机编号，首个虚拟机默认为 100 ：

项目	子列表	说明
常规	名称	OpenWrt
操作系统	-	不使用任何介质
系统	机型	q35
系统	BIOS	UEFI
系统	UEFI存储	local-lvm
系统	-	请不要勾选预签名
磁盘	-	删除掉默认分配磁盘
CPU	核心	2
CPU	类别	host
CPU	内存	1024MB
网络	-	默认网桥vmbr0

然后，进入PVE的shell中，为OpenWrt导入系统盘：

qm importdisk 100 /var/lib/vz/template/iso/openwrt-x86-64-generic-squashfs-combined-efi.img local-lvm

参数说明，一般情况下只需修改镜像文件名：

100：虚拟机编号
openwrt-x86-64-generic-squashfs-combined-efi.img：镜像文件名
local-lvm：虚拟存储地址

等待导入完毕后，回到OpenWrt的硬件：

双击未使用磁盘，点击确定以启用。

再前往选项 -> 引导顺序：仅勾选新添加的磁盘，例如 scsi0 ，最后启动该虚拟机。

OpenWrt系统配置

进入OpenWrt的控制台shell中后，输入如下命令更改基础网络配置：

vi /etc/config/network

修改LAN口的 ip_address 为 192.168.22.1 ，这对应着PVE最初设置的网关地址。

注意，这里用到的vim编辑器：

键入i进入编辑模式
键入esc退出编辑模式，回到阅览模式
键入:进入命令模式，紧跟输入wq进行保存和退出

然后输入命令reboot或者点击PVE的重启按钮，来重启虚拟机。

等待重启完成，我们这时就可以用PC来访问OpenWrt的后台了，地址为：http://192.168.22.1

网络配置

现在我们仍有一个网口，甚至还有一个ax101网卡，那么就有两种方案：

用物理网口2来作为wan口连接外网
用无线网卡扫描连接外网Wi-Fi作为wan口上网

物理网口2上网

首先到PVE后台，创建WAN口网桥：

随后在OpenWrt虚拟机的硬件里，添加该网络 vmbr1，并在物理网口2上插上连接外网的网线。

进入OpenWrt的后台，进入网络 -> 网口配置，将eth0(vmbr0、物理网口1)接入LAN,将eth1(vmbr1、物理网口2)接入WAN。

再进入网络 -> 防火墙，打开数据接收：

等待网络连接成功，在PVE中将OpenWrt设置为开机自启动，并在PC网络中打开DHCP。

无线网卡上网

这次我们来到PVE后台，需要为OpenWrt直通AX101(例)无线网卡硬件，请先关闭OpenWrt系统：

然后启动OpenWrt系统，以便识别直通硬件。

再进入OpenWrt后台页面，进入网络 -> 无线，选择识别到的网卡，进行连接Wi-Fi：

连接成功后，一般将直接分配一个wwan配置，作为外网的入点，随后配置防火墙。

进入网络 -> 防火墙，打开数据接收：

等待网络连接成功，在PVE中将OpenWrt设置为开机自启动，并在PC网络中打开DHCP。

路由器AP无线WI-FI传播

这里我的机器只有两个物理网口，由于要连接路由器做AP，因此我这里以无线网卡上网为例。

这时我们会空余一个物理网口2，然后进入PVE后台的网络配置，将nic1(物理网口2)也添加进vmbr0(LAN)网桥。

我们要先对路由器进行一些设置，用网线连接PC与路由器，查看网关，在浏览器中输入网关地址，进入路由器后台。

随后可以参考之前的文章家庭网络连接 | 路由器接入方式 | 旁路由上网 | Router 中，关于 LAN口入网 的详细配置。

主流路由器现在都有工作模式选择的权利，以我使用的 锐捷 RG-MA3063(中国移动) 为例，就可以直接选择 桥模式，以避免繁杂的DHCP与IP设置。

深澜Srun校园网认证系统

笔者使用无线网卡上网，便是连接的校园网，有幸在 GitHub 上找到了HAUT的OpenWrt自动登录脚本，在此鸣谢：HAUT Network Guard

笔者在这里也找到了一些有关深澜Srun系统的项目：

AstrBot部署 | Mac Mini | Docker容器化

Thu, 26 Feb 2026 00:00:00 GMT

链接

精简docker安装

首先，确保你的macOS环境中安装了Homebrew：

# 检查版本
brew --version
# 安装Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

然后，安装orbstack作为docker的运行平台，再安装docker和compose：

brew install --cask orbstack docker docker-compose

orbstack相关命令：

# 开机
orb start
# 状态
orb status
# 下机
orb stop
# 配置docker
orb config docker

确保orbstack处于运行状态，最后运行命令 配置docker，设置一下镜像源：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live/"
  ]
}

这里用到了vim编辑器，首次进入是查看模式，轻触 I 键进入写入模式，ESC 退出当前模式，键入 : 进入命令模式，输入 wq 进行保存和退出。

部署astrbot和napcat

这里使用官方文档自带的部署方式，同时安装napcat：

mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
sudo docker compose -f astrbot.yml up -d

如果网络问题获取不到compose文件，下面是官方的 astrbot.yml:

# docker-compose.yml
# NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose -f ./compose/astrbot.yml up -d
services:
  napcat:
    environment:
      - NAPCAT_UID=${NAPCAT_UID:-1000}
      - NAPCAT_GID=${NAPCAT_GID:-1000}
      - MODE=astrbot
    ports:
      - 6099:6099
    container_name: napcat
    restart: always
    image: mlikiowa/napcat-docker:latest
    volumes:
      - ./data:/AstrBot/data
      - ./napcat/config:/app/napcat/config
      - ./ntqq:/app/.config/QQ
    networks:
      - astrbot_network
    #mac_address: "02:42:ac:11:00:02"
  astrbot:
    environment:
      - TZ=Asia/Shanghai
    image: soulter/astrbot:latest
    container_name: astrbot
    restart: always
    ports:
      - "6185:6185"
      #- "6195:6195"
      #- "6199:6199"
    volumes:
      - ./data:/AstrBot/data
    networks:
      - astrbot_network
networks:
  astrbot_network:
    driver: bridge

部署完成后，查看容器日志：

sudo docker logs napcat
sudo docker logs astrbot

注意查看astrbot和napcat的WebUI地址和token信息：

astrbot的账密默认为 astrbot
napcat的默认token在日志中随机生成

随后进入astrbot的webui，设置适配器：

随后进入napcat的webui，登录要作为机器人的QQ号，进行网络设置:

至此，就可以在astrbot的平台日志中，看到机器人接收消息的logs了。

最后就是配置模型服务商，进行astrbot本体插件的必要设置后，就可以使用了。

sandbox沙箱环境配置

在astrbot中，如果让大模型调用电脑能力来实现功能(python、matlab画图)，一般需要配置沙箱环境，让AI的操作不伤害到宿主机。

官方推荐使用 Shipyard 项目来实现沙箱环境：

mkdir astrbot-shipyard
cd astrbot-shipyard
wget https://raw.githubusercontent.com/AstrBotDevs/shipyard/refs/heads/main/pkgs/bay/docker-compose.yml -O docker-compose.yml
# 修改 compose-with-shipyard.yml 文件中的环境变量配置，例如 Shipyard 的 access token 等
docker compose -f docker-compose.yml up -d
docker pull soulter/shipyard-ship:latest

这里还是给出compose文件的内容：

version: '3.8'

services:
  shipyard:
    image: soulter/shipyard-bay:latest
    ports:
      # API port (public, for agent access)
      - "8156:8156"
      # Dashboard port (optional, can be hidden behind NAT)
      - "8157:8157"
    environment:
      - PORT=8156
      - DATABASE_URL=sqlite+aiosqlite:///./data/bay.db
      - ACCESS_TOKEN=secret-token
      - MAX_SHIP_NUM=10
      - BEHAVIOR_AFTER_MAX_SHIP=reject
      - CONTAINER_DRIVER=docker
      - DOCKER_IMAGE=soulter/shipyard-ship:latest
      - DOCKER_NETWORK=shipyard_network
      - SHIP_DATA_DIR=${PWD}/data/shipyard/ship_mnt_data
      - DEFAULT_SHIP_CPUS=1.0
      - DEFAULT_SHIP_MEMORY=512m
    volumes:
      - ${PWD}/data/shipyard/bay_data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - shipyard

networks:
  shipyard:
    name: shipyard_network
    external: true

可以在compose文件里设置 ACCESS_TOKEN：将 secret-token 改为预设值即可。

随后在astrbot的 配置文件 -> 普通配置 中即可设置启用sandbox环境：

插件的安装

在astrbot插件市场中有非常多各种各样的插件，这使得astrbot机器人的功能变得丰富多样，这里以 API聚合 插件为例。

一般来说点击安装即可，随后会弹出该插件的说明文档，这里通常有一些注意事项：

这里提到的 倾梦API 需要自行手动获取key，再去到webui界面进行配置。

由于我们的astrbot安装在docker中，docker的网络端口只有映射出来的，宿主机才能访问。

因此我们需要对 astrbot.yml 进行修改:

# ...
  astrbot:
# ...
    ports:
      - "6185:6185"
# 在这里添加4141的端口映射
      - "4141:4141"
# ...

然后重新以docker-compose重启astrbot即可：

cd ~/astrbot
sudo docker stop astrbot
sudo docker compose -f astrbot.yml up -d

这时再访问4141端口就可以访问到 API聚合 插件的webUI界面了。

中科云数据胶囊——免费大容量的S3云笔记obsidian同步空间

Tue, 24 Feb 2026 00:00:00 GMT

中科院国家队的对象存储--中科云数据胶囊

首先推荐注册中国科技云通行证

这里填写的 手机号实名信息 要与上边的 真实姓名 一致；账号邮箱地址填写国内邮箱，例如qq和163。

随后前往中国科技云数据胶囊选择 中国科技云通行证 进行登录。

未实名用户只有1GB存储空间，且无法使用客户端访问数据(S3、WebDav等)，因此需要进行实名认证，首先到中科云数据胶囊的账户信息，选择实名认证。

这里需要用到 国家网络身份认证 APP申领网号来进行实名，在手机应用商店中直接搜索即可下载。

下面引用百度百科的申领教程：

这样就能成功领取到你的网号，相关法规科普见国家网络身份认证公共服务管理办法--百度百科。

最后在 国家网络身份认证 APP中扫描中科云数据胶囊的实名认证二维码，即可获得20GB免费存储空间。

这里也可以进行微信绑定，可以随时将微信中的文件上传到该数据胶囊。

中科云数据胶囊已经自动分成了几个类别空间，我们最终将使笔记作为obsidian云同步的基地。

获取中科云数据胶囊S3客户端信息

选择 客户端访问 笔记，来到S3客户端信息处：

记下信息(例)：

Endpoint: s3.endpoint
Bucket: s3-bucket
AccessKey ID
AccessKey Secret

使用Remotely Save云同步obsidian笔记

首先进入Obsidian的设置页面，选择 第三方插件，关闭 安全模式 后，浏览 插件市场。

搜索并安装 Remotely Save 插件，进入选项：

填写完必要信息后，进行连接测试，成功后自行选择同步策略。

回到obsidian仓库，随意编写一个markdown，在侧边快捷栏会出现 Remotely Save 的同步按钮。

同步之后，回到中科云数据胶囊的笔记，即可看到被同步的文件：

Folo创作者所有权认证文章

Mon, 23 Feb 2026 00:00:00 GMT

This message is used to verify that this feed (feedId:248766985642333184) belongs to me (userId:202297656391504896). Join me in enjoying the next generation information browser https://folo.is.

家庭网络连接 | 路由器接入方式 | 旁路由上网 | Router

Tue, 10 Feb 2026 00:00:00 GMT

路由器与光猫

路由器（Router）是连接两个或多个网络的硬件设备，在网络间起网关的作用，是读取每一个数据包中的地址然后决定如何传送的专用智能性的网络设备。————来自百度百科

光调制解调器，也称为单端口光端机或光猫，是针对特殊用户环境而研发的一种三件一套的光纤传输设备。————来自百度百科

对于当前普遍光纤入户的家庭网络来说，光猫(光调制解调器)被特殊集成了路由器功能。

然而光猫的本职工作最初只是将光信号转换为电信号，因此家庭光猫也可以视作一个路由器对待。

网络分层与网络类型

图片内容来自维基百科和菜鸟教程。

路由器是一个工作在网络层的硬件设备，只能作用于网络层及其之上的网络层级。

路由器工作方式

对于只有一台终端路由设备的家庭网络而言，通常光猫会工作在路由模式下，此时这就是一个带光电转换功能的路由器，核心功能是进行 宽带PPPoE拨号 和 DHCP自动分配IP，前者是让光猫通过数据链路层与服务商对接，后者是为家庭内网设备分配子网IP。没有IP的设备无法在广域网中准确接收信息，也就是无法上网，因此家庭网络中一定要有一个启用DHCP功能的设备。

WLAN无线局域网已然成为刚需，部分光猫尽管带有无线功能，但本身机能有限，因此配备一台无线路由器是针对WLAN下设备提升网络质量的一种方案。对于无线路由器来说，相比于上文中的光纤入户光猫，普遍没有光电转换功能，但拥有了更好的机能和自由度。

光猫与无线路由器的连接分为两种：

光猫的LAN口接路由器的WAN口
光猫的LAN口接路由器的LAN口

路由器WAN口入网

此时连入路由器的所有设备都与光猫处于不同网段，相应的光猫和路由器IP也不同。例如，光猫IP为192.168.1.1，分配给路由器的IP为192.168.1.2；而路由器也有DHCP功能，因此另找了一个网段，在路由器子域中，它的IP为192.168.3.1，所连接的设备IP就被分配为为192.168.3.x。

先讲正确的入网方式：

将光猫设置为桥接模式 | 一般需要咨询服务商/宽带师傅
将 宽带PPPoE拨号、DHCP自动分配IP 等功能迁移至路由器配置

光猫桥接后，就简单地“退化”成了一个光电转换设备，此时光猫的所有功能都迁移至无线路由器，因此需要进行拨号和宽带设置，DHCP一般会默认开启。

非正确入网：

光猫依然处于路由模式，关闭无线模块。
路由器仅设置 DHCP自动分配IP，开启无线功能。

这种模式下，所有连入路由器WLAN的设备，会处于二级子网下，如果想要连通广域网，就需要两次NAT转换：

NAT旨在通过将一个外部 IP 地址和端口映射到更大的内部 IP 地址集来转换 IP 地址。 ————来自百度百科

路由器将设备IP转换为光猫分配的IP
光猫将分配的IP转换为WAN口的服务商公网IP

如果是在游戏场景下(大多数为UDP数据传输)，网络层的NAT转换消耗了传输层的传输时间，在游戏中的表现为延迟不稳定，时常出现网络卡顿，这也是 校园网 的多数工作方式，导致风评极差。

路由器LAN口入网

这里默认大家的子网掩码为255.255.255.0，因此DHCP的全段分配地址为192.168.1.2到192.168.1.254。

对于开启DHCP功能的设备来说，下发的默认网关IP地址就是它本身，总之子网设备流量会经过被设置的网关设备；而DNS地址由光猫从运营商自动获取，但这里依旧整理了一些公共DNS地址：

服务商	首选地址	备选地址
Google	`8.8.8.8`	`8.8.4.4`
Cloudflare	`1.1.1.1`	`1.0.0.1`
~~Microsoft~~ Lumen	`4.2.2.1`	`4.2.2.2`
阿里巴巴	`223.5.5.5`	`223.6.6.6`
腾讯	`119.29.29.29`	`182.254.116.116`

LAN口入网方式下，连入路由器的所有设备都与光猫处于同一网段，而与上文中的WAN口入网不同。例如，光猫IP为192.168.1.1，DHCP的范围为192.168.1.2到192.168.1.100，则设置路由器的IP为192.168.1.101，其他连入路由器的设备IP也由光猫的DHCP来分配，因此IP为192.168.1.x。(x从2~100)

路由器作为AP进行有线中继：

光猫保持路由模式，关闭无线模块。
进入光猫后台，破坏DHCP的全段分配，例如设置分配范围为192.168.1.2到192.168.1.253，留出192.168.1.254。
路由器关闭 DHCP自动分配IP，设置网关、DNS为光猫地址192.168.1.1，举例设置路由器IP为192.168.1.254。

此时就是 光猫无线信号不好 的针对性方案，仅将路由器作为无线模块。

旁路由模式

此部分比较硬核，笔者也涉猎不多，一般的家庭网络也没有必要如此。

基础设置：

光猫保持路由模式
进入光猫后台，破坏DHCP的全段分配，例如设置分配范围为192.168.1.2到192.168.1.253，留出192.168.1.254。
路由器关闭 DHCP自动分配IP，设置网关、DNS为光猫地址192.168.1.1，举例设置路由器IP为192.168.1.254。
旁路由系统(OpenWRT)防火墙开启入站、出站数据和转发。

旁路由的最直接应用就是zerotier搭建虚拟局域网和进行附魔操作。

如果只是单设备流量走旁路由，只需要在连入旁路由的网络设置中，IP分配改为手动，并设置：

IP地址为例中192.168.1.2到192.168.1.253中未占用的IP
网关和DNS都指向旁路由例中的192.168.1.254
子网掩码为255.255.255.0

如果全部流量都想走旁路由(附魔)：

进入光猫后台，将DHCP的默认网关、DNS指向旁路由，即例中的192.168.1.254。
进入OpenWrt系统防火墙，开启 IP动态伪装 (NAT)功能。

静态网页的文章管理后端！| Decap-CMS | GitHub-OAuth

Mon, 09 Feb 2026 00:00:00 GMT

CMS

内容管理系统（英语：content management system，缩写为 CMS）是指在一个合作模式下，用于管理工作流程的一套制度。———— 来自维基百科

对于静态网站，特别是博客，如果只是编写文章，却需要与Git仓库打交道，未免过于繁琐，因此有这么一类CMS系统，专对静态网站的文章进行管理，且只需要在Web端即可完成文章操作，便于随时随地随心记录点子/修改文章。

DecapCMS

这是一个基于 Git 的静态站点生成器 CMS，相关链接：

由于该CMS起源于NetlifyCMS，后独立出来，因此大多数教程适用于您的网站托管在Netlify的情况下。但我这里是基于GitHub_OAuth的认证所做的教程，静态网站可托管至任意平台，当然所有的细枝末节都可以前往官方文档页查看请详情。

Install | 安装

官方提供了两种安装方式：

通过静态路由下的admin文件夹内编写配置
通过npm将decap-cms以包的形式安装

这里首选第一种安装方式，基于静态网站所使用的框架，确定静态文件夹的所在地，在此目录下创建admin文件夹。

随后在admin文件夹下创建文件index.html，内容如下：

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="robots" content="noindex" />
    <title>Content Manager</title>
  </head>
  <body>
    <!-- Include the script that builds the page and powers Decap CMS -->
    <script src="https://unpkg.com/decap-cms@^3.0.0/dist/decap-cms.js"></script>
  </body>
</html>

再创建config.yml文件，按照官方教程按需配置即可，下一节将展示我个人的一个模板。

当配置好config后，就可以通过https://<yoursite>/admin(将<your-site>替换为具体网站域名)来访问decap-cms系统。

Configuration | 配置

首先放出适用于GitHub认证的模板：

# 配置好您所选用的后端，这里我用的是GitHub_OAuth作为后端。
backend:
  name: github
  branch: main
  repo: <your-repo-name> # 替换为您的静态网站仓库名
  site_domain: <your-site-domain> # 替换为您的静态网站域名
  base_url: <github-oauth-site-url> # 替换为配置好的GitHub_oAuth后端网站链接(包含https协议头)
  auth_endpoint: auth

  # (可选项)自定义Decap-CMS每次操作的提交信息模板。
  commit_messages:
    create: "CMS:Create {{collection}} “{{slug}}”"
    update: "CMS:Update {{collection}} “{{slug}}”"
    delete: "CMS:Delete {{collection}} “{{slug}}”"
    uploadMedia: "CMS:Upload “{{path}}”"
    deleteMedia: "CMS:Delete “{{path}}”"
    openAuthoring: "CMS:{{message}}"

# Decap-CMS的首页logo
logo_url: https://blog.srprolin.top/favicon/favicon.ico

# 您的网站地址链接(带HTTPS协议头)
site_url: <your-site-url>
display_url: <your-site-url>

# 媒体文件夹，填写图片存放位置
media_folder: "<your-img-location>"
# 引用路由补全，在Decap-CMS选择图片时自动补全的路径头。
public_folder: "<your-img-head-url>"
# 例如你的图片为 "img.png"，存放在 "src/images/"(媒体文件夹)下，文章为 "index.md"，而文章存放在 "src/posts/"下，那么这时候就要补全路径头为 "../images"

# 文档夹(核心)
collections:

  # 分类1(按名称"name"分类)
  - name: "posts" # Used in routes, e.g., /admin/collections/blog
    # 在Decap-CMS网页上的分类名称(只影响web的展示文字)
    label: "Posts" # Used in the UI

    # 填写文章位置
    folder: "<your-posts-location>" # The path to the folder where the documents are stored
    create: true # Allow users to create new documents in this collection
    slug: "{{year}}-{{month}}-{{day}}-{{slug}}" # Filename template

    # CMS编辑器预置项(按需调整)
    fields: # The fields for each document, usually in front matter
      - { label: "标题", name: "title", widget: "string" }
      - {
          label: "发布日期",
          name: "published",
          widget: "datetime",
          format: "YYYY-MM-DD",
        }
      - {
          label: "置顶",
          name: "pinned",
          widget: "boolean",
          default: false,
          required: false,
        }
      - {
          label: "摘要",
          name: "description",
          widget: "string",
          required: false,
        }
      - { label: "封面", name: "image", widget: "image", required: false }
      - {
          label: "标签",
          name: "tags",
          widget: "list",
          minimize_collapsed: true,
          required: false,
        }
      - { label: "分类", name: "categories", widget: "list", required: false }
      - {
          label: "草稿",
          name: "draft",
          widget: "boolean",
          default: false,
          required: false,
        }
      - {
          label: "语言",
          name: "lang",
          widget: "string",
          default: "",
          required: false,
        }
      - { label: "正文", name: "body", widget: "markdown", required: false }

  # 分类2
  - name: "pages"
    label: "Pages"
    # 单文件陈列
    files:
      - file: "<your-pages-location-head>/about.md" # 替换为你的页面位置前缀
        name: "about"
        label: "关于"
        fields:
          - { label: "内容", name: "body", widget: "markdown", required: false }
      - file: "<your-pages-location-head>/friends.md" # 替换为你的页面位置前缀
        name: "friends"
        label: "友链"
        fields:
          - { label: "内容", name: "body", widget: "markdown", required: false }

在配置单中，除backend后端选项外，其他均为通用配置项。

GitHub_OAuth是需要自行申请，并配置后端的，在下一节中将给出教程。

这个后端，无非就是认证“你是你”这件事，DecapCMS同样也有通过Netlify身份认证来做后端的配置，但那就需要你的网站托管在Netlify了，更何况即使网站托管在Netlify，但多数静态站的源码还是在GitHub上的，那干脆就用GitHub_OAuth做认证后端好了。

GitHub_OAuth应用配置

这里我们要用到Cloudflare的Workers做真实后端逻辑，(当然其他的CI/CD平台也可以，但我提供的是适用于Worker的代码) 选择从hello,world!开始，自定义worker_name后直接部署。

随后在部署好的worker中，选择 编辑代码 ，内容如下：

export default {
  async fetch(request, env) {
    const url = new URL(request.url);

    // 路由 1: 登录入口
    if (url.pathname === "/auth") {
      const state = crypto.randomUUID();
      const githubAuthUrl = `https://github.com/login/oauth/authorize?client_id=${env.GITHUB_CLIENT_ID}&scope=repo&state=${state}`;

      return new Response("Redirecting...", {
        status: 302,
        headers: {
          "Location": githubAuthUrl,
          "Set-Cookie": `sx_state=${state}; HttpOnly; Secure; Path=/; Max-Age=600; SameSite=Lax`,
        },
      });
    }

    // 路由 2: 回调处理
    if (url.pathname === "/callback") {
      const code = url.searchParams.get("code");
      const returnedState = url.searchParams.get("state");
      const cookies = request.headers.get("Cookie") || "";
      const savedState = cookies.match(/sx_state=([^;]+)/)?.[1];

      if (!returnedState || returnedState !== savedState) {
        return new Response("安全校验失败：State 不匹配，请求可能已被篡改。", { status: 403 });
      }

      const response = await fetch("https://github.com/login/oauth/access_token", {
        method: "POST",
        headers: {
          "content-type": "application/json",
          "accept": "application/json"
        },
        body: JSON.stringify({
          client_id: env.GITHUB_CLIENT_ID,
          client_secret: env.GITHUB_CLIENT_SECRET,
          code,
        }),
      });

      const data = await response.json();

      if (!data.access_token) {
        return new Response("GitHub 授权失败", { status: 401 });
      }

      // 返回给 Decap CMS 的握手信号
      const content = `
        <html><body><script>
        (function() {
          function receiveMessage(e) {
            window.opener.postMessage(
              'authorization:github:success:${JSON.stringify({
                token: data.access_token,
                provider: "github"
              })}',
              e.origin
            );
          }
          window.addEventListener("message", receiveMessage, false);
          window.opener.postMessage("authorizing:github", "*");
        })()
        </script></body></html>`;

      return new Response(content, {
        headers: {
          "content-type": "text/html",
          "Set-Cookie": "sx_state=; HttpOnly; Secure; Path=/; Max-Age=0",
        }
      });
    }

    return new Response("OAuth Proxy is running", { status: 200 });
  },
};

部署后，为该后端添加自定义域名，那么通过https://<your-oauth>即可访问，若配置成功，则会返回信息"OAuth Proxy is running"，此时后端中仍缺少两项环境变量。

前往GitHub的开发者设置中，选择OAuth Apps，并创建New OAuth App，按下图填写：

随后回到CloudflareWorker中，填写两个键值对环境变量，类型选择为secret(密钥)：

GITHUB_CLIENT_ID : <Client ID>
GITHUB_CLIENT_SECRET : <Client secret>

此时的GitHub_OAuth后端就算部署完成了。

Nintendo_Switch插件仓库列表 | AMS | RDP

Sun, 08 Feb 2026 00:00:00 GMT

Nintendo Switch 相关插件仓库列表

sphaira——任天堂Switch的自制菜单
nx-hbmenu——任天堂Switch的自制菜单
Awoo-Installer——任天堂Switch的无废话NSP、NSZ、XCI和XCZ安装程序
sys-con——支持第三方控制器的 Nintendo Switch 系统模块
linkalho——一款可将 NID 账户链接离线的用户浏览应用。
SwitchThemeInjector——为任天堂交换机创建自定义主题!
wiliwili——第三方B站客户端。
JKSV——JK的保存管理器Switch版。
DBI——安装NSP、NSZ、XCI和XCZ的终极解决方案,支持通过MTP、USB、http(来自您的个人服务器)、外部USB等设备进行安装。
Ultrahand-Overlay——完全精巧的任天堂Switch外带执行器。
Ultrahand-Packages——已知Ultrahand插件包的完整列表。
SysDVR——通过USB或网络将游戏流式传输到电脑。
EdiZon——Homebrew 为任天堂Switch的操作系统Horizon保存文件递质、注射器和控制台编辑器。

RDP烤鸭包

Cloudflare优选原理小记

Fri, 06 Feb 2026 00:00:00 GMT

CloudflareCDN与优选

作为互联网中的重要角色，其CDN节点遍布全球，提供了非常多的入口IP。由于GFW的存在，中国大陆的访问情况并不是很友好，但总归有访问良好的节点IP。优选即是对Cloudflare的全球IP进行测试，选择出优于中国大陆访问的IP。

DNS——IP与域名的映射表

DNS服务器用于针对客户端发送的域名请求，查找并返回客户端相对应的IP，由于CDN节点网络分发技术的存在，访问一个网页的域名(例如baidu.com)，不同地区最终返回的IP是不同的。

如果我们将Cloudflare优选后的众多IP，与一个域名相绑定，并保留在DNS服务器上，那么这个域名就是优选域名。

CloudflareWorkers路由

Workers是Cloudflare的一项功能，用于部署静态网页、动态脚本等severless应用，提供两种绑定域名方式：

自定义域名——自动添加DNS记录
自定义路由——将指定的域名路由转发至此Worker应用

由上文可知，如果要使用优选域名，就需要自定义DNS记录，将自定义域名指向优选IP/域名，因此对于Worker应用使用优选域名加速，只能使用 自定义路由 方式来绑定自定义域名

应用示例

假设你有一个worker应用，你的自定义域名为 example.domain.com , 你所选用的优选域名为 better.cf.com：

进入worker应用，选择 自定义路由，绑定至 example.domain.com/*
进入DNS记录，添加一条CNAME(如果是IP选A类型)解析，将example.domain.com解析至better.cf.com

Switch系统更新 | AMS | hekate

Thu, 05 Feb 2026 00:00:00 GMT

双系统整体框架

硬件破解时植入芯片MCU，构建出了一套拥有机器最高权限的虚拟系统，而AMS实现了该虚拟系统与机身正版系统的共存。

真实系统为带有最高权限的正版系统，仅限于超频等发挥机器性能等操作。
虚拟系统为与正版系统完全隔离的最高权限系统，无法使用任天堂网络服务。
正版系统为机身原始系统，常使用于任天堂第一方网络游戏。 hekate可以类比做PC中的BIOS，是在系统加载前的启动页面，用于硬件读取和系统选择，常与AMS一起打入整合包。

更新步骤

请优先关注：

大气层系统版本及其所支持的Switch版本
任天堂Switch最新版本，点击前往官网最新更新公告页

如果大气层未能支持最新的Switch版本，请不要更新正版系统！

硬件准备

一台PC/任意设备——用于进行文件替换
SD内存读卡器/数据线——用于连接Switch与操作平台

软件准备

AMS整合包/AMS官方包结合hekate——双系统前提
Firmware固件包——用于虚拟系统的更新

连接Switch与操作平台

在Switch重新启动进入hekate界面后，选择USB的SD卡选项，将数据线(或者将Switch关机，取出SD卡，使用读卡器)连接至操作平台，打开SD卡根目录。

请一定保留文件夹，其他视情况而定：

Nintendo——正版系统数据
emuMMC——虚拟系统数据

随后将AMS整合包解压后目录列表和 Firmware 整个文件夹拖入至SD卡根目录，最后在操作平台安全弹出移动存储设备。

更新虚拟系统

首先查看AMS系统版本是否为所使用的版本，判断是否更新完成。随后打开相册中的应用 Daybreak，选择固件位置 Firmware 文件夹进行更新安装。

更新正版系统

正常联网更新即可。

SrP-CFG安装器v2版本 | 使用指南

Mon, 12 Jan 2026 00:00:00 GMT

前言

请先阅读前篇关于CFG的介绍，必要时阅读SrP-CFG项目说明书。

项目地址

::github{repo="RolinShmily/SrP-CFG_ForCS2"}

该安装器仅适用于Windows_x64位系统使用。

界面展示

默认勾选安装 CFG文件(全局配置) 和 视频预设文件(用户配置) ，请按需勾选所需要安装的预设。
默认的CFG文件安装路径是全局生效(非730)，而视频预设文件只能在730文件夹的用户级目录生效，所以如果您需要安装视频预设文件cs2_video.txt,请选定你的steam用户，该码为steam好友代码，下一节将提供好友代码的查找细节。
文件选择处可以提供单文件形式.zip、.cfg、.txt，也可以选中多个文件/一整个文件夹，选择器会自动滤除掉非.cfg和.txt类型文件。
备份可以单独执行，在安装时也会强制执行一次备份；如果你的备份需要存档，请手动转移位置，或者更改备份文件名；备份位置右侧可以打开文件夹，并自动选中备份文件，便于用户查找。
刷新路径按钮，用于手动执行扫描steam安装路径、steam游戏路径、steam用户文件夹，当然如果仍未找到，你可以点击路径右侧的...手动指定路径。
当一切准备就绪，就可以点击开始安装。
你的每一步操作都会在日志输出中打印提示信息，如果遇到问题，请先查看日志。

你会需要的链接

项目说明书 | 本项目的一些废话
下载地址 | 顾名思义
使用指南 | 按键、控制台命令功能表
更新日志 | 查看最新更新

steam好友代码查找

如果你有更多方便的查找好友代码的方式，欢迎反馈。

steam客户端查找

方式1:

方式2:

steam网页端查找

访问链接：Steam社区

请先在右上角登录你的steam账户，随后操作同客户端方式2查找一致。

基于webDAV的远程文件虚拟盘符挂载

Thu, 25 Dec 2025 00:00:00 GMT

前言

借助 RaiDrive 实现挂载盘符，同时使用 GitHub 上的开源 webDAV 服务端，避免了 Windows 自带的 IIS 的繁琐配置。

使用到的外链：

webdav 服务端的安装与配置

前往 hacdias/webdav 项目的 Release 页，以 Windows 系统为例，安装对应的 amd64 版本。

演示安装目录：E:\Program Files\webdav

根据官方的 README 文件，需要自行创建config.yaml来进行配置，下面是官方配置的 AI 翻译版：

# 监听地址：0.0.0.0 表示允许局域网或内网穿透流量访问
address: 0.0.0.0
# WebDAV 服务在本地运行的端口
port: 6065

# TLS 相关设置。如果你不配置域名证书，请保持 false
tls: false
cert: cert.pem
key: key.pem

# WebDAV 路径前缀。默认为 '/'。如果是 '/share'，访问地址需加上该后缀
prefix: /

# 是否启用调试日志。默认 'false'
debug: false

# 是否禁用探测文件内容类型。默认 'false'
noSniff: false

# 服务端是否运行在受信任的代理之后（如 Nginx）。
# 开启后将使用 X-Forwarded-For 记录真实的远程访问地址。
behindProxy: false

# 默认共享目录：当用户没有单独定义 directory 时使用此路径。
# '.' 代表当前可执行文件所在的目录。你可以改为具体路径，如 "D:/MyShare"
directory: .

# 默认权限设置（不区分大小写）。
# C (创建), R (读取), U (更新/修改), D (删除)。
# 如果只想让朋友看和下，设为 "R"；如果需要他能上传和改名，设为 "CRUD"。
permissions: R

# 默认权限规则。规则从下往上应用（最后一条匹配的规则生效）。
# 路径始终相对于用户的根目录。
rules: []

# 用户规则的叠加行为：
# - overwrite: 用户定义的规则将覆盖全局规则。
# - append: 用户的规则将附加在全局规则之后。
rulesBehavior: overwrite

# 日志配置
log:
  # 日志格式 ('console' 易读, 'json' 适合分析)。
  format: console
  # 是否开启彩色打印。
  colors: true
  # 日志输出位置，默认为标准错误流 'stderr'。
  outputs:
    - stderr

# CORS 跨域配置（如果你使用网页版客户端访问，需要开启）
cors:
  enabled: true
  credentials: true
  allowed_headers:
    - Depth
  allowed_hosts:
    - http://localhost:8080
  allowed_methods:
    - GET
  exposed_headers:
    - Content-Length
    - Content-Range

# 用户列表。如果列表为空，则不启用身份验证（不安全）。
# 否则，将自动配置基础身份验证 (Basic Auth)。
users:
  # 示例管理员账号 (明文密码)
  - username: admin
    password: YourStrongPassword # 建议修改此密码
    permissions: CRUD # 管理员通常拥有完全权限

  # 示例普通用户 'john'，使用了 bcrypt 加密密码，并指定了专属目录
  - username: john
    password: "{bcrypt}$2y$10$zEP6oofmXFeHaeMfBNLnP.DO8m.H.Mwhd24/TOX2MWLxAExXi4qgi"
    directory: D:/JohnsFiles # 这里必须是绝对路径或有效的相对路径

  # 从系统环境变量中读取用户名和密码的示例
  - username: "{env}ENV_USERNAME"
    password: "{env}ENV_PASSWORD"

  # 具有细分权限规则的用户示例
  - username: basic
    password: basic
    permissions: CRUD # 基础权限是全开
    rules:
      # 禁止该用户访问 /some/file 路径
      - path: /some/file
        permissions: none
      # 允许该用户在 /public/access/ 目录下进行增删改查
      - path: /public/access/
        permissions: CRUD
      # 允许该用户读取和更新所有以 .js 结尾的文件（使用正则表达式）
      - regex: "^.+.js$"
        permissions: RU

这里给到我的简易配置：

address: 0.0.0.0
port: 6065
tls: false

cors:
  enabled: false

prefix: /
directory: ./MyShare

log:
  format: console
  colors: true
  outputs:
    - stderr

rulesBehavior: overwrite
users:
  # 管理员
  - username: admin
    password: password # 建议修改此密码
    permissions: CRUD # 管理员通常拥有完全权限
  # 其他用户
  - username: user
    password: user
    permissions: R
    directory: ./MyShare/User

注意：

确保你的根目录下有MyShare和MyShare/User文件夹，且该文件夹权限为全部(支持读写)。
请考虑修改你的管理员用户名和密码。

随后双击程序webdav.exe，可以通过http://localhost:6065检验是否成功运行。

为了无痛无感启动，可以编写一个start_webdav.vbs脚本：

CreateObject("Wscript.Shell").Run "webdav.exe -c config.yaml", 0, True

这样启动脚本后，便不会有 cmd 命令窗，程序将静默后台运行。

随后为该脚本创建一个快捷方式，Win+R打开运行窗，输入shell:startup，会打开一个启动文件夹，将快捷方式拖入进去即可。

这样就获得了一个开机自启的 webdav 服务。

RaiDrive 挂载器 | 客户端的安装与配置

前往 RaiDrive 官网下载安装对应的 Windows_x64 版本。

我们可以先在自己启动 webdav 服务端的 PC 上，使用 RaiDrive 挂载一下本地的 MyShare 文件夹：

随后可以看到电脑中多了一个 X 盘，说明服务端配置成功。

结语

到这里，我们就可以利用各种内网穿透服务，通过获取的公网地址，来访问 WebDAV 服务器。

基于SMB和Postgres的Davinci协同工作

Sun, 21 Dec 2025 00:00:00 GMT

SMB 文件共享

百度百科：

SMB（全称是 Server Message Block）是一个网络协议名，它能被用于 Web 连接和客户端与服务器之间的信息沟通。SMB 最初是 IBM 的贝瑞·费根鲍姆（Barry Feigenbaum）研制的，其目的是将 DOS 操作系统中的本地文件接口“中断 13”改造为网络文件系统。

本文的 SMB 搭建参考自 Windows SMB 正确安全的开启姿势

打开 SMB 共享功能

Win+R打开运行框，输入optionalfeatures打开 Windows 功能，勾选SMB 直通。

创建 SMB 专用用户

这里的用户名以SMB为例。

Win+R打开运行框，输入compmgmt.msc打开计算机管理。

必要用户权限的限制与开放

Win+R打开运行框，输入gpedit.msc打开本地组策略。

Win+R打开运行框，输入secpol.msc打开本地安全策略。

同样的操作应用于以下选项：

Win+I打开 Windows 设置，按照下图打开必要选项：

设置 SMB 共享文件夹

选择任意盘符，创建一个文件夹，名字以SMB为例。

随后打开 SMB 文件夹属性：

其他计算机设备的连接

现在在另一台设备上，Win+E打开资源管理器，选择此电脑，按照下列操作，即可获得一个Z 盘，里面是上文的SMB文件夹内容。

请注意：

这里的文件夹路径中的10.10.10.1为共享机的内网地址，SMB为共享文件夹名
网络凭据中用户名为上文中创建的SMB，密码也是上文创建用户时的密码

PostgreSQL 数据库

达芬奇官方支持中心中的DaVinci Resolve Project Server本质上是一个 Postgre 数据库，我们可以完全不用这样一个软件，而用 Postgres 代替。

前往Postgres 官方下载中心，下载 Windows 版本安装包，在安装过程中会设置一个默认的数据库用户名和密码：

默认用户名：postgres
(例)密码：password

现在可以Win+R打开运行框，输入services.msc并找到postgres相关服务，查看是否正在运行。

数据库连接权限

找到 PostgreSQL 的根目录，用记事本打开这个文件：...\PostgreSQL\17\data\pg_hba.conf

在末尾加上一段通行信息：

# Allow network access
host    all             all             10.10.10.0/24         scram-sha-256

这里的10.10.10.0/24对应上文中10.10.10.1的网段，这样位于该网段下的其余设备，才能通过10.10.10.1地址来连接到数据库

你需要查询自己的内网网段，替换掉10.10.10.0/24。

数据库可视化工具测试

这里推荐一款可视化数据库管理工具DBeaver。

可以在10.10.10.1机器上，连接数据库时，测试地址10.10.10.1看是否能连接成功。

不过在一般情况下管理，直接用localhost或者127.0.0.1即可。

Davinci 达芬奇协同设置

在10.10.10.1机器上，打开达芬奇软件，按下列操作：

位置填写10.10.10.1可以保持统一。

在内网的其他机器上，只需要选择连接，填入相同内容即可。

项目文件夹设置

在10.10.10.1机器上，通过映射网络驱动器操作，获得相同的一个Z 盘。

在网络数据库中创建一个新项目，前往项目设置：

如图所示确保工作文件夹均在Z 盘内。

结语

尽管这样确实能实现两台 PC 的协同工作，但因为种种原因，最好将 Postgres 数据库和项目资源聚合在某一台“服务器”上(比如 NAS)，而不是生产 PC。

MC整合包MacMini实装 | rcon远程终端控制 | launchd系统进程守护

Sat, 20 Dec 2025 00:00:00 GMT

前言

之前发布过一篇在MacMini上借助mcsmanager管理Minecraft服务器的文章: 使用MacMini搭建Minecraft服务器，但是对于betterMC这样的大型forge整合包，通过JVM运行通常已经很吃内存了。

又因为实测下来mcsmanager的管理操作其实并不是很好用，他在指令层也会套一层壳，这导致我前段时间误判了服务端JVM已经关闭，但是其并没有释放，在查看硬件后台之后才发现同时运行了多个JVM，导致负载极高且卡顿。

鉴于mcsmanager的操作并不顺手，且Node.js的后端也同样吃不少内存(相对于要开服务器的16G丐版Mini)，且存在一定的内存泄漏风险，我决定放弃mcsmanager的方案。

这篇文章将Minecraft服务端启动脚本(自制)写入launchd守护进程，使用rcon远程控制台向服务器发送指令，一切行为经过命令行。

BetterMC整合包

我们这里安装的服务端，可以说是私人型服务器，即对外不公开地址，仅朋友间游玩整合包使用，因此也选择了较为经典的原版增强型整合包，且使用forge核心，这是一个相当吃配置的选择，但也能印证方案可行性。

下面是一些相关链接：

这里建议先用Windows下载一份服务端，至于客户端整合包导入这里不多赘述，会的都会了。

服务端初始化

该整合包的服务端是由ServerPackCreator工具制作的，且mojang也不允许二次分发Minecraft相关文件，所以该服务端在初始启动时是需要下载模组等，客户端导入时同理。

这里建议将服务端先下载到PC，解压后进行初始化操作，由于模组源来自 curseforge ，因此需要自行解决网络环境。

解压后如图中所示：

根据 READ_ME 文件，我们可以找到官方向导地址：https://github.com/chorbintime/LPS-readme/wiki/1.20.1

官方提供了安装Java的脚本：install_java.ps1和install_java.sh

但相信大家都提前安装过了Java，所以我们打开variables.txt文件，将跳过Java版本检测设置为true并手动设置自己的Java路径。

文件在顶部注释中已经说明了Windows的路径写法，可参考如下文件：

    ###
    # Remember:
    #   Escape \ and : in your Java path on Windows with another \
    #   Example:
    #     From: C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot\bin\java.exe
    #     To:   C\:\\Program Files\\Eclipse Adoptium\\jdk-17.0.9.9-hotspot\\bin\\java.exe
    #   More on escape characters at https://en.wikipedia.org/wiki/Escape_character
    # ......
    ###
    MINECRAFT_VERSION=1.20.1
    MODLOADER=Forge
    MODLOADER_VERSION=47.4.10
    LEGACYFABRIC_INSTALLER_VERSION=1.1.0+1
    FABRIC_INSTALLER_VERSION=1.1.0
    QUILT_INSTALLER_VERSION=0.12.1
    RECOMMENDED_JAVA_VERSION=1.20.1
    JAVA_ARGS="-Xmx4G -Xms4G"
 -- JAVA="java"
 ++ JAVA=D:\\Program Files\\zulu17.62.17-ca-jdk17.0.17-win_x64\\bin\\java.exe
    WAIT_FOR_USER_INPUT=true
    ADDITIONAL_ARGS=-Dlog4j2.formatMsgNoLookups=true
    RESTART=false
 -- SKIP_JAVA_CHECK=false
 ++ SKIP_JAVA_CHECK=true
    JDK_VENDOR=graalvm
    JABBA_INSTALL_URL_SH=https://github.com/Jabba-Team/jabba/raw/main/install.sh
    JABBA_INSTALL_URL_PS=https://github.com/Jabba-Team/jabba/raw/main/install.ps1
    JABBA_INSTALL_VERSION=0.13.0
    SERVERSTARTERJAR_FORCE_FETCH=true
    SERVERSTARTERJAR_VERSION=latest
    USE_SSJ=true

随后在Windows环境下，直接双击start.bat启动脚本，进行初始化下载。

等待过后键入list命令看到如下输出，说明启动成功：

> list
There are 0 of a max of 20 players online:

文件结构应当如下所示，myserver_start.sh是我们稍后要编写的启动脚本：

通过Launchd和rcon管理整合包服务器

官方启动脚本过于繁琐，有较多的检测机制，因此我只用于初始化安装必要的文件，而实际的启动用到更简洁的自编写脚本，myserver_start.sh(适用于Linux和macOS)，修改自MineKuai_Wiki：

#!/bin/bash

SERVER_DIR="your/server/path"
JAVA_EXEC="your/java/path"
MEMORY="8G"

JAVA_ARGS="-server -Xms${MEMORY} -Xmx${MEMORY} -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=20 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=16M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:SurvivorRatio=32 -XX:MaxTenuringThreshold=1 -XX:+UseStringDeduplication -XX:+UseCompressedOops -XX:+UseCompressedClassPointers -Dfml.readTimeout=180 -Dfml.debugRegistryEntries=true -Dfile.encoding=UTF-8"

FORGE_UNIX_ARGS="libraries/net/minecraftforge/forge/1.20.1-47.4.10/unix_args.txt"

cd "${SERVER_DIR}" || exit 1
echo "Starting Minecraft server..."

exec "${JAVA_EXEC}" ${JAVA_ARGS} @"${FORGE_UNIX_ARGS}" nogui

注意：

请将SERVER_DIR变量更改为你的服务器目录值
请将JAVA_EXEC变量更改为你将使用的JAVA路径值
JAVA的安装和路径查找请到上篇文章使用MacMini搭建Minecraft服务器中自行查找

随后我们可以将整个文件夹打包，上传至MacMini的SERVER_DIR目录并解压。

launchd守护进程

我们这里选择使用系统服务，即在/Library/LaunchDaemons/下创建com.betterMCv54.plist文件：

# 创建并编辑plist文件
sudo nano /Library/LaunchDaemons/com.betterMCv54.plist

文件内容大致如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.betterMCv54</string>

    <key>UserName</key>
    <string>YOUR_USERNAME</string>

    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>/YOUR/PATH/TO/SERVER_DIR/myserver_start.sh</string>
    </array>

    <key>WorkingDirectory</key>
    <string>/YOUR/PATH/TO/SERVER_DIR</string>

    <key>ProcessType</key>
    <string>Interactive</string>
</dict>
</plist>

请注意：

将YOUR_USERNAME替换为你的当前用户名
将/YOUR/PATH/TO/SERVER_DIR(文件中有两处)替换为你具体的SERVER_DIR的绝对路径

确保权限正确：

sudo chown root:wheel /Library/LaunchDaemons/com.betterMCv54.plist
sudo chmod 644 /Library/LaunchDaemons/com.betterMCv54.plist

加载配置，并启用服务(即开服)：

sudo launchctl load /Library/LaunchDaemons/com.betterMCv54.plist
sudo launchctl start com.betterMCv54

# 如果在启用服务后修改了配置文件，请确保游戏服务器停止后，停止服务，并重载配置
sudo launchctl stop com.betterMCv54
sudo launchctl unload /Library/LaunchDaemons/com.betterMCv54.plist
sudo launchctl load /Library/LaunchDaemons/com.betterMCv54.plist

使用rcon工具向服务器发送指令

Minecraft服务器默认不开启rcon功能，我们需要到SERVER_DIR的server.properties文件中修改，默认端口为25575：

    #Minecraft server properties
    #Mon Jun 03 21:13:36 CDT 2024
    allow-flight=true
    allow-nether=true
    broadcast-console-to-ops=true
    broadcast-rcon-to-ops=true
    difficulty=normal
    enable-command-block=true
    enable-jmx-monitoring=false
    enable-query=false
 -- enable-rcon=false
 ++ enable-rcon=true
    enable-status=true
    enforce-secure-profile=true
    enforce-whitelist=false
    entity-broadcast-range-percentage=100
    force-gamemode=false
    function-permission-level=2
    gamemode=survival
    generate-structures=true
    generator-settings={}
    hardcore=false
    hide-online-players=false
    initial-disabled-packs=
    initial-enabled-packs=vanilla
    level-name=world
    level-seed=
    level-type=bclib\:normal
    max-chained-neighbor-updates=1000000
    max-players=20
    max-tick-time=60000
    max-world-size=29999984
    motd=Better MC [FORGE] 1.20.1
    network-compression-threshold=256
    online-mode=true
    op-permission-level=4
    player-idle-timeout=0
    prevent-proxy-connections=false
    pvp=true
    query.port=25565
    rate-limit=0
 -- rcon.password=
 ++ rcon.password=yourpassword
    rcon.port=25575
    require-resource-pack=false
    resource-pack=
    resource-pack-prompt=
    resource-pack-sha1=
    server-ip=
    server-port=25565
    simulation-distance=10
    spawn-animals=true
    spawn-monsters=true
    spawn-npcs=true
    spawn-protection=16
    sync-chunk-writes=true
    text-filtering-config=
    use-native-transport=true
    view-distance=10
    white-list=false

请注意：

将yourpassword改为你的密码，确保不要泄露，下面的rcon-cli使用中，也替换为你的密码。

我们选择的远程控制台工具为rcon-cli，一款命令行rcon工具。

# 回到用户目录
cd ~

# 从GitHub下载rcon-cli并解压，简化路径
curl -O https://github.com/gorcon/rcon-cli/releases/download/v0.10.3/rcon-0.10.3-arm64_darwin.tar.gz
tar -zxvf rcon-0.10.3-arm64_darwin.tar.gz
mv rcon-0.10.3-arm64_darwin.tar.gz rcon

# 进入应用目录并添加环境变量
cd rcon
echo 'export PATH="$PATH:/Users/remote/rcon"' >> ~/.zprofile && source ~/.zprofile

# 检测版本，验证环境变量
rcon --version

# 单行使用
rcon -a localhost:25575 -p yourpassword

为了使用方便，我们可以编辑rcon.yaml文件，编写默认的主机地址和密码：

# 前往rcon目录
cd ~/rcon/

# 编辑rcon.yaml
nano rcon.yaml

内容大致如下：

default:
  address: "localhost:25575" # host:port, for example 127.0.0.1:16260
  password: "yourpassword"
  log: "rcon-default.log"
  type: "" # rcon, telnet, web.
  timeout: "10s"

这样设置后的使用流程就为：

# 进入rcon目录，执行rcon命令即可进入rcon控制台
cd ~/rcon
rcon

# 使用举例
username@192 ~ % cd ~/rcon
username@192 rcon % rcon
Waiting commands for localhost:25575 (or type :q to exit)
> list
There are 0 of a max of 20 players online:
> :q
username@192 rcon %

服务器关服与重启

这里我们将MacMini作为服务器使用，那么硬件机器是长期保持运行的，而macOS的自动休眠机制经常会阻止这样的行为，因此我们使用caffeinate声称一个重要进程，进而阻止休眠。

依旧使用launchd守护进程：

# 创建并编辑plist
sudo nano /Library/LaunchDaemons/local.caffeinate.plist

内容大致如下(参数选择为-ims这里不添加-d参数是防止显示器不会自动熄屏)：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>local.caffeinate</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/caffeinate</string>
        <string>-ims</string>
    </array>
    <key>UserName</key>
    <string>root</string>
</dict>
</plist>

给予权限并加载运行：

sudo chown root:wheel /Library/LaunchDaemons/local.caffeinate.plist
sudo chmod 644 /Library/LaunchDaemons/local.caffeinate.plist
sudo launchctl load /Library/LaunchDaemons/local.caffeinate.plist
sudo launchctl start local.caffeinate

对于长期运行的硬件而言，我们的com.betterMCv54服务也是一直存在的，除非我们stop这个服务(这里是针对launchd守护进程)。

正确的关服，只需要通过rcon向服务器发送stop指令，游戏服务器便会保存当前世界数据。

服务器重新启动，只需要在命令行唤醒服务，触发脚本即可：sudo launchctl start com.betterMCv54。

使用MacMini搭建Minecraft服务器 | MCSmanger面板 | SakuraFRP樱花映射

Sun, 07 Dec 2025 00:00:00 GMT

简介

本篇文章将从头手把手：

通过命令行搭建起 mcsmanager 服务器面板，依靠它作为服务器终端和文件管理；
使用樱花内网映射服务来做公网地址，仅使用其魔改版 frpc 客户端，通过启动脚本且仅需命令行无需 GUI 使用；
并结合自定义域名，设置 SRV 类型 DNS 记录，确定最终的服务器地址。

依据标题所说，目前搭建 Minecraft 服务器最推荐的设备就是 MacMini_M4 了，能耗比几乎拉满；因此本篇教程是针对 arm64 架构的 macOS 系统，且使用默认终端 shell-Zsh 的命令行，真正手把手跑后台，也避免了 GUI 使用不熟练的理解问题。

MCSManager 面板安装

这是官方文档：快速开始 | MCSmanager

官方文档并没有提供 MacOS 系统的教程，但是根据 up 主一只会魔法的梨所发布的视频【MC 开服】macOS 如何本地安装 MCSManager 可知，macOS 本身提供了类似 Unix 的命令行环境，只需要提供 Darwin 内核依靠 arm64 的 M4 芯片所需要的依赖，便可以把 Linux 软件移植到 macOS_M4 运行。

下面将结合官方 Linux 教程，下载 arm64_macOS 所需依赖，安装 MCSManager。

运行时环境 nodeJS

MCSManager 所需的运行环境，用于构建 web 服务器，便于我们从浏览器操作服务器。

这里是node 官方的下载页面，下面将先安装Homebrew：

# 这里默认你的macOS没有任何命令行操作历史，因此先安装Homebrew工具
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

# 将homebrew添加进Zsh(默认终端)的PATH(环境变量)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile

#  测试查看brew版本
brew --version

参数说明：

PATH环境变量，是针对 macOS 的默认终端Zsh，你可以通过echo $SHELL来查看当前终端类型；
/opt/homebrew/bin/brew是 M 系列芯片安装的默认位置，Intel 芯片位置可能不同，自行查询；
~代表当前用户，也即此 PATH 只添加到当前用户的Zsh终端中

下面是安装 node(包含 npm 包管理器)：

# 通过homebrew安装
brew install node@24

# 为node24添加软链接
brew link node@24

# 测试查看node版本
node -v

tips：这里已经确保homebrew添加进了 PATH 环境变量，由于安装的 node 是具体版本，所以需要手动创建软链接，以便于在终端中使用命令。

安装 Java

既然是搭建 Java 的 Minecraft 服务器，那当然需要 Java 了，在官方文档中也提出了某些 Java 版本对应的 Minecraft 版本，这里我只安装 Java17 和 Java21：

# 通过brew安装openjdk17
brew install openjdk@17

# 添加软链接
brew link openjdk@17

# 检测版本
java -version

# 安装openjdk21
brew install openjdk@21

# 先取消旧链接，再添加新软链接
brew unlink openjdk@17
brew link openjdk@21

# 检测版本
java -version

# 查看当前Java的绝对路径
ls -l /opt/homebrew/bin/java
# 得到类似信息
lrwxr-xr-x  1 remote  admin  36 Dec  7 17:25 /opt/homebrew/bin/java -> ../Cellar/openjdk@21/21.0.9/bin/java
# 那么你的Java绝对路径为
/opt/homebrew/Cellar/openjdk@21/21.0.9/bin/java

学会查看 Java 的绝对路径，后面将使用绝对路径写启动脚本。

MCSManager 本体

依照官方教程，获取安装包并执行安装脚本：

# 前往用户家目录
cd ~

# 获取安装包并解压
curl -O https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz
tar -xzf mcsmanager_linux_release.tar.gz

# 删除压缩包，进入项目目录
rm mcsmanager_linux_release.tar.gz
cd mcsmanager/

# 为安装脚本授予完全权限并运行
chmod 775 ./install.sh
sh ./install.sh

接下来，就需要安装 macOS_M4 所需要的依赖PTY和Zip-tools：

# 前往目标目录
cd ~/mcsmanager/daemon/lib/

# 安装arm64的pty
curl -O https://github.com/MCSManager/PTY/releases/download/latest/pty_darwin_arm64

# 安装arm64的zip-tools
curl -O https://github.com/MCSManager/Zip-Tools/releases/download/latest/file_zip_darwin_arm64

下面执行启动脚本，进行测试，(通过Ctrl+C来终止)：

./start-daemon.sh
./start-web.sh: 这是官方的 web 页面启动脚本。

由于有两个脚本，所以需要两个终端来执行，这也是官方文档中的最终使用教程。

下面我将两个脚本注册为 launchd 系统服务，长期保持在后台，且自动恢复，实现无痕长期运行。

launchd 系统服务

我们需要先创建一个日志目录，用来存储脚本的运行消息：

# 创建日志目录
mkdir -p ~/mcsmanager/logs

# 创建系统服务plist文件(使用nano编辑器)
sudo nano /Library/LaunchDaemons/com.mcsmanager.daemon.plist

com.mcsmanager.daemon.plist文件内容大致如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.mcsmanager.daemon</string>

    <key>ProgramArguments</key>
    <array>
        <string>这里填写你的start-daemon.sh脚本绝对路径</string>
    </array>

    <key>WorkingDirectory</key>
    <string>这里填写你的mcsmanager绝对路径</string>

    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
    </dict>

    <key>StandardOutPath</key>
    <string>这里填写你的daemon.log日志文件绝对路径</string>

    <key>StandardErrorPath</key>
    <string>这里填写你的daemon-error.log日志文件绝对路径</string>

    <key>UserName</key>
    <string>这里填写你的服务运行用户名</string>
</dict>
</plist>

参数说明(将文件中的中文改成所需参数)，假设我们的用户名是test：

start-daemon.sh脚本绝对路径举例：/Users/test/mcsmanager/start-daemon.sh
mcsmanager绝对路径举例：/Users/test/mcsmanager/
daemon.log日志文件绝对路径举例(上文中已经创建了 logs 用来存储日志)：/Users/test/mcsmanager/logs/daemon.log
daemon-error.log日志文件绝对路径举例：/Users/test/mcsmanager/logs/daemon-error.log
服务运行用户名举例：test

创建 web 界面脚本的 plist 服务文件：

# 使用nano编辑器编辑文件
sudo nano /Library/LaunchDaemons/com.mcsmanager.web.plist

com.mcsmanager.web.plist文件内容大致如下，依据上文举例的以test用户名为例，请按需调整：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.mcsmanager.web</string>

    <key>ProgramArguments</key>
    <array>
        <string>/Users/test/mcsmanager/start-web.sh</string>
    </array>

    <key>WorkingDirectory</key>
    <string>/Users/test/mcsmanager/</string>

    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
    </dict>

    <key>StandardOutPath</key>
    <string>/Users/test/mcsmanager/logs/web.log</string>

    <key>StandardErrorPath</key>
    <string>/Users/test/mcsmanager/logs/web-error.log</string>

    <key>UserName</key>
    <string>test</string>
</dict>
</plist>

最后，确保服务文件属于 root，并加载配置，启动服务：

# 文件所属
sudo chown root:wheel /Library/LaunchDaemons/com.mcsmanager.daemon.plist
sudo chown root:wheel /Library/LaunchDaemons/com.mcsmanager.web.plist

# 加载配置
sudo launchctl load /Library/LaunchDaemons/com.mcsmanager.daemon.plist
sudo launchctl load /Library/LaunchDaemons/com.mcsmanager.web.plist

# 启动服务
sudo launchctl start com.mcsmanager.daemon
sudo launchctl start com.mcsmanager.web

# 查看服务是否运行
sudo launchctl list | grep mcsmanager

# 查看日志
tail -f ~/mcsmanager/logs/daemon.log
tail -f ~/mcsmanager/logs/web.log

如果需要停止该服务，请按下列执行：

# 先终止服务
sudo launchctl stop com.mcsmanager.daemon
sudo launchctl stop com.mcsmanager.web

# 卸载配置
sudo launchctl unload /Library/LaunchDaemons/com.mcsmanager.daemon.plist
sudo launchctl unload /Library/LaunchDaemons/com.mcsmanager.web.plist

使用面板搭建服务器

现在我们已经成功部署了 mcsmanager，如果你在使用 MacMini 的 GUI，也就是说你是本机，请在浏览器输入http://127.0.0.1:23333访问面板，如果你是远程环境，请自行解决内部网络问题。

在 web 页面内使用 Minecraft 模板创建服务器，都是懒人操作，这里不做详细步骤说明了。

现在假设你已经创建了一个实例并进入了 web 后台页面，你需要对服务器启动命令进行设置。

按照图中的例子，1.21.4的 Minecraft 需要jdk21版本来运行，内存限制为最小 2G 最高 4G，使用 UTF-8 编码输入输出，且我的服务端核心名为paper-1.21.4-232.jar，则启动命令为： /opt/homebrew/Cellar/openjdk@21/21.0.9/bin/java -Xms2G -Xmx4G -Dfile.encoding=utf-8 -Dstdout.encoding=utf-8 -Dstderr.encoding=utf-8 -Djline.terminal=jline.UnsupportedTerminal -jar paper-1.21.4-232.jar -nogui

樱花内网穿透

如果你会使用 GUI 来运行官方的启动器客户端，是否有过要保持开启该软件的困扰？

这里将用 frpc 的方式来启用隧道，并将启动脚本注册为系统服务，实现无痕穿透。

这是官方的 frpc 下载页面：软件下载 | SakuraFrp

创建隧道

进入官方隧道列表

选择创建隧道，任意选物理位置较近的节点，按照下面的配置：

Minecraft_Java 版服务器，是通过 TCP 协议通信的，比较特殊，端口不进行更改默认为 25565。

sfrp 命令启用隧道

这里我们是 Mac_mini_M4 硬件，因此选择左侧macOS Apple Silicon (arm64)，复制下载链接。

# 进入用户家目录，创建SakuraFrp文件夹并进入
cd ~
mkdir sakura_frp
cd sakura_frp/

# 下载樱花官方frpc
curl -O https://nya.globalslb.net/natfrp/client/frpc/0.51.0-sakura-12.3/frpc_darwin_arm64

# 授予执行权限
chmod +x frpc_darwin_arm64

# 添加软链接到Homebrew，注册名为sfrp
# 原因是brew已经在环境变量PATH里了
# 这里的test要替换成你的用户名
ln -s /Users/test/sakura_frp/frpc_darwin_arm64 /opt/homebrew/bin/sfrp

# 检测版本
sfrp -v

至此，已经可以使用官方提到的类似格式frpc -f <访问密钥>:<隧道ID 1>[,隧道ID 2[,隧道ID 3...]]来启动隧道。而具体到我们现在的环境，举例密钥为wdnmdtoken6666666，隧道 ID1 为114514，隧道 ID2 为114516，则命令为：

# 启用两个隧道
sfrp -f wdnmdtoken6666666:114514,114516

这样仍然不能解决该终端需要一直保持开启的痛点，下面将提供一个脚本start_sfrp.sh来保存配置，并注册至 launchd，在系统后台自动运行，且如果有新隧道或更换用户，只需要对start_sfrp.sh内容进行修改，重载服务配置即可。

樱花穿透 launchd 服务

# 进入目标路径
cd ~/sakura_frp/

# 创建编辑start_sfrp.sh脚本
nano start_sfrp.sh

start_sfrp.sh脚本内容大致如下(注意替换test用户名)：

#!/bin/bash

FRPC_PATH="/Users/test/sakura_frp/frpc_darwin_arm64"

ACCESS_KEY="<key>"
TUNNEL_IDS="<tunnel_id>"

exec $FRPC_PATH -f $ACCESS_KEY:$TUNNEL_IDS

参数说明：

<key>:替换为你的访问密钥，在官方后台首页可获得。
<tunnel_id>：替换为你的隧道 ID，访问官方隧道列表，无需复制，已经展示出来了，例如114514和1114516；如果你是单隧道，只填写数字即可，如果是多隧道，以英文,隔开，例如TUNNEL_IDS="114514,114516"。

# 添加执行权限
chmod +x start_sfrp.sh

# 创建日志目录
mkdir log

# 创建服务plist文件
sudo nano /Library/LaunchDaemons/com.frp.sfrp.plist

com.frp.sfrp.plist文件内容大致如下(将test替换为你的用户名)：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.frp.sfrp</string>

    <key>ProgramArguments</key>
    <array>
        <string>/Users/test/sakura_frp/start_sfrp.sh</string>
    </array>

    <key>StandardOutPath</key>
    <string>/Users/test/sakura_frp/log/sfrp_stdout.log</string>
    <key>StandardErrorPath</key>
    <string>/Users/test/sakura_frp/log/sfrp_stderr.log</string>

    </dict>
</plist>

# 设置权限
sudo chown root:wheel /Library/LaunchDaemons/com.frp.sfrp.plist

# 加载服务并运行
sudo launchctl load /Library/LaunchDaemons/com.frp.sfrp.plist
sudo launchctl start com.frp.sfrp

# 查看日志
tail -f ~/sakura_frp/log/sfrp_stdout.log
tail -f ~/sakura_frp/log/sfrp_stderr.log

此时在官方隧道列表，可以看到隧道已被启用。

如果你的脚本内容发生更改，请重载 launchd 服务：

sudo launchctl stop com.frp.sfrp
sudo launchctl unload /Library/LaunchDaemons/com.frp.sfrp.plist
sudo launchctl load /Library/LaunchDaemons/com.frp.sfrp.plist
sudo launchctl start com.frp.sfrp

至此已经可以优雅地进行服务器地址的配置了。

服务器地址

使用樱花内网穿透，官方已经提供了一个访问地址了，在官方隧道列表，点击那个数字，即可复制到服务器地址，类似frp-art.com:114514,这个地址已经可以用来连接到服务器了。

如果你拥有一个域名，那么你可以写一条 SRV 类型的 DNS 记录指向你的自定义域名，来作为服务器地址。

下面将以 Cloudflare 的 DNS 为例，创建自定义域名地址：

结语

至此，只要你的机器在运行，你随时可以通过 web 面板访问服务器终端，且服务器地址是一直生效的。

现在你就可以优雅地进行宣传服务器了。

内网穿透Frp搭建

Fri, 05 Dec 2025 00:00:00 GMT

简介与摘要

frp 是一个专注于内网穿透的高性能的反向代理应用，支持 TCP、UDP、HTTP、HTTPS 等多种协议，且支持 P2P 通信。可以将内网服务以安全、便捷的方式通过具有公网 IP 节点的中转暴露到公网。

市面上的内网穿透服务Sakura FRP也是基于此实现的。

本文将以 Ubuntu24 系统公网云服务器为例，Frp 官方压缩包版本为 v0.65.0，分享部署自用内网穿透服务的步骤。

文中未提到的多处细节，请参考官方文档自行了解。

Frp 部署

官方的 release 界面下载到的压缩包中，会包含 frpc 客户端和 frps 服务端两个程序，我们一般在服务器上保留 frps，在需要穿透的内网机器上保留 frpc，我将分别演示在服务端(Linux)和客户端(Windows)上的操作：

Frps 服务端

分步总览：

下载官方压缩包并解压进入项目目录
删除有关客户端 frpc 的文件
编辑 frps.toml 以初始化服务端配置
为 frps 创建 systemd 后台服务文件
将 frps 归入系统后台服务并开机自启

命令行操作(关于wget网络问题，可以自行下载好压缩包之后，通过sftp上传至服务器)：

# 在用户目录下(不必使用sudo)，获取并解压官方amd64(服务器系统框架)版本最新压缩包：
cd ~
wget https://github.com/fatedier/frp/releases/download/v0.65.0/frp_0.65.0_linux_amd64.tar.gz
tar -xvf frp_0.65.0_linux_amd64.tar.gz

# 更名项目文件夹名,并进入项目目录
mv frp_0.65.0_linux_amd64 frps
cd frps/

# 删除客户端frpc相关文件
rm frpc
rm frpc.toml

现在我们需要编辑frps.toml文件内容，这里使用nano编辑器：nano frps.toml

文件内容大致如下：

# frps.toml

bindAddr = "0.0.0.0"

# 这里是frps服务端口，需要在云厂商安全组和系统防火墙中打开
bindPort = 7000

webServer.addr = "0.0.0.0"

# 这里是frps提供的web页面端口，同样需要开放
webServer.port = 7500

# 这是web页面的初始访问密码
webServer.user = "admin"

webServer.password = "admin"

# 这是用于连通客户端与服务端的凭证码，请设置复杂些
auth.token = "Jdag0XDeMnzcPI"

现在按照官方用法，只需要执行./frps -c ./frps.toml便可开启服务，并在 7500 端口查看 frps 的 web 页面。

但是此时该服务只能运行在 ssh 终端，也就是说关闭了 ssh 连接，frp 服务也将终止。

因此按照官方文档的推荐方法，可以将 frps 注册为 systemd 系统服务，跑在服务器后台。

# 安装systemd(一般会内置)
sudo apt install systemd

# 创建并编辑frps.service文件(需要sudo权限)
sudo nano /etc/systemd/system/frps.service

内容大致如下：

# frps.service

[Unit]
# 服务名称，可自定义
Description = frp server
After = network.target syslog.target
Wants = network.target

[Service]
Type = simple
# 启动frps的命令，需修改为您的frps的安装路径
ExecStart = /home/usrname/frps/frps -c /home/usrname/frps/frps.toml

[Install]
WantedBy = multi-user.target

随后通过systemctl启动frps服务(systemctl常用参数:start、stop、restart、status)：

# 启动frps，可访问7500端口或用status参数查看是否运行成功
sudo systemctl start frps

# 设置frps为自启动
sudo systemctl enable frps

Frpc 客户端

分步总览：

下载并解压官方压缩包
删除 frps 相关文件
编辑frpc.toml配置初始化
编辑bat和vbs文件以达到后台效果
通过 web 界面编辑穿透服务

这里以 amd64 的 Windows 系统为例，点击下载官方压缩包

以C:\Program Files\frpc目录为例，存放解压后的文件。

删除frps.exe和frps.toml两个文件。

编辑frpc.toml内容如下：

# frpc.toml

# 请写入你的服务器公网IP或者域名替换"<IP>"
serverAddr = "<IP>"

# 默认端口为7000
serverPort = 7000

# 这里填写刚才在frps.toml中填写的认证凭证token
auth.token = "Jdag0XDeMnzcPI"

# 默认Web界面使用本机7400端口
webServer.addr = "127.0.0.1"
webServer.port = 7400

# web界面初始用户名密码
webServer.user = "admin"
webServer.password = "admin"

此时我们双击运行frpc.exe文件就能运行该服务，但是它需要跑在终端里。

下面将使用bat脚本+vbs脚本的方式，让该服务跑在后台，不占用前台终端。

在该目录下创建start_frpc.bat文件，编辑内容如下：

@echo off
title FRP Client
echo starting frp client...
echo logs_output：
echo ==============================

:: 切换到frpc所在目录（请替换为实际路径）
cd /d C:\Program Files\frpc

:: 启动frpc并将日志输出到文件
frpc.exe -c frpc.toml> frpc_log.txt 2>&1

:: 如果启动失败，暂停显示错误信息
if %errorlevel% neq 0 (
    echo FRP Client start failed！
    echo error messages are saved in frpc_log.txt
    pause
)

创建start_frpc.vbs文件，编辑内容如下：

Set objShell = CreateObject("WScript.Shell")
objShell.Run "cmd /c start_frpc.bat", 0, False

随后为start_frpc.vbs创建一个桌面快捷方式，双击快捷方式即可在后台运行，可访问http://127.0.0.1:7400检查是否成功。

Frp 示例 | 穿透本机游戏端口

在上面的教程中，只是成功部署了 frp 服务，我们部署 frpc 客户端也是为了显示本机应用端口的穿透，下面将演示 Minecraft_Java 游戏服务器和 CS2 游戏房间的穿透案例。

运行start_frpc.vbs启动客户端后，前往web 页面:

我这里是已经部署成功后的页面，点击左边configure可以实现在 web 页面编辑frpc.toml文件：

按照此格式写入后，点击upload即可更新配置文件，便可实现内网穿透：

[[proxies]]
name = "minecraft"
type = "tcp"
localIP = "127.0.0.1"
localPort = 25565
remotePort = 25565

参数说明：

name：只用做服务标识，可以随便设置
type：对于当前案例来说，多数网游使用udp，而 Minecraft_Java 版游戏使用tcp
localIP：一般不用更改，127.0.0.1 表示本机。
localPort：根据需要的服务端口而言，这里 Minecraft 服务器默认跑在 25565 端口，CS2 房间是跑在 27015 端口。
remotePort：指的是别人需要通过远程服务器上的哪个端口来访问你本机的游戏服务器，该端口需要在云厂商安全组中放行，可与本地游戏服务端口不一致。

结语

本人对 Frp 的使用是非常有限的，实际上官方文档中对 Frp 的功能介绍远比我这里多得多，本文旨在展示这么一样东西，了解 Frp 的基础操作逻辑和参数说明，可以帮大家在使用比如 Sakura FRP 樱花内网穿透时，不那么茫然。

SrP-CFG_Installer_v1.1.1命令行程序 | CS2 | CFG

Tue, 25 Nov 2025 00:00:00 GMT

简介

该项目是为了方便用户安装SrP-CFG而设计的，其功能就是替代了用户手动寻找路径并解压的步骤。

如果您未知CFG是什么？或者SrP-CFG是什么？请移步访问前篇：SrP-CFG 游戏设置预设文件 | CS2

关于SrP-CFG项目，以下为项目文档链接：

项目说明书 | 本项目的一些废话
下载地址 | 顾名思义
使用指南 | 按键、控制台命令功能表
更新日志 | 查看最新更新

后续可能会更新GUI版本，并支持cs2_video.txt文件导入目标730文件的需求。

功能说明

目前版本v1.1.1的功能：

自动识别steam安装路径
自动识别CS2游戏安装路径(主要是全局cfg文件夹)
支持多cfg文件或zip压缩包(只筛入cfg文件)拖入
自动备份用户游戏全局cfg文件夹至上层目录的cfg_backup.zip中

使用说明

前往项目Release或者文档页下载地址下载安装器。

双击运行后如下图所示，推荐下载配套的SrP-CFG压缩包，拖入即可安装。

Autoexec文件详解 | SrP-CFG | CS2

Tue, 18 Nov 2025 00:00:00 GMT

简介

这是以我制作的CS2游戏预设文件SrP-CFG中的autoexec.cfg文件为主体的，一篇功能解析文章。

在Bilibili平台已发布该文件的部分功能的游戏实现演示，请移步访问：BV19pCQB6EPZ

如果您未知CFG是什么？或者SrP-CFG是什么？请移步访问前篇：SrP-CFG 游戏设置预设文件 | CS2

截止文章发布时，最新版本为v1.1.0，以此为例进行功能说明。

下面将对文件进行解析说明。

整体框架与使用思路

虽然该文件出自SrP-CFG集合，但是其最初或者本应承担的功能，如同它的名字(自动加载)一样，是保存游戏基础设置。

因此该文件，也可以脱离SrP-CFG进行使用，但是我将不会提供单独的下载链接，如有需要，还请前往文档页进行下载SrP-CFG，再从中提取出autoexec.cfg单独使用：

项目说明书 | 本项目的一些废话
下载地址 | 顾名思义
使用指南 | 按键、控制台命令功能表
更新日志 | 查看最新更新

文件功能定义分区：

鼠标相关设置
基础按键绑定(前后左右跳)
联动CFG启动按键
基础准星(自定义准星替换)
狙击镜准星(粗细、扩散否？)
投掷物准星(正交坐标系准星)
准星杂项(❌不准打队友)
持枪视角(手模型位置)
雷达
网络、延迟、帧数显示
边角小功能设置(曳光弹、亮度、连镜、消音器)
快捷聊天轮盘(不开麦时神器)
声音
HUD界面(血量颜色、回合记分牌位置)
杂项
控制台别名功能绑定区
联动CFG初始化
控制台导航(在你启动后控制台会弹出的消息菜单)

根据功能分区可以知道，这份文件确实是完全可以单独使用的，必要的一些设置都是涵盖的。

控制台导航信息是文件自定义功能的一些按键指南，在游戏中如果有忘记的，可以打开控制台一览，快速查询。

各分区各功能详解

鼠标相关设置

sensitivity 0.5625                 // 灵敏度
zoom_sensitivity_ratio 1 		   // 开镜灵敏度
m_yaw 0.022                        // x轴速度

这里前两行都是对标游戏设置里的选项。

小技巧tips：在设置鼠标灵敏度时，使用控制台，是可以精准设置数字的。例如这里文件中设置的0.5625,如果你在游戏的那个设置条(Bar)上拉一个数字也是0.562,但是你在控制台中输入sensitivity，你会发现控制台提示，你的灵敏度是随机数比如0.56234536456。

对于第三项x轴速度，严格来说是游戏摄像机的x轴角度系数，但为了方便理解，还是用x轴速度吧，在CS中主要涉及到分辨率相关的问题。我们知道现在的主流游戏、显示器、视频都是16:9，也就是我们日常使用电脑时的分辨率；而大多数CS玩家的复古分辨率4:3拉伸，会导致画面被水平拉伸至两侧，这样使游戏人物变宽,但也带来的问题就是鼠标的光标也被拉宽、水平速度变快了。

在游戏中默认0.022的x轴速度为16:9下的默认参数。也就是如果你游戏是16:9，那么鼠标的移动速度是和平时使用一样的；但如果你是4:3拉伸，拉伸带来的速度加快，也是会体现到你游戏视角中的。

为了匹配鼠标横向和纵向的移动速度，在4:3拉伸的情况下，可以调整参数为0.0165,还原到日常使用鼠标时带来的反馈速度。我这里没有调整，请自行按需尝试修改。

基础按键绑定

bind "w" "+forward"                // 向前移动
bind "s" "+back"                   // 向后移动
bind "a" "+left"                   // 向左移动
bind "d" "+right"                  // 向右移动
bind "mouse1" "+attack"            // 普通攻击
bind "mouse2" "+attack2"           // 特殊攻击
bind "mouse_x" "yaw"               // 鼠标水平移动控制视角
bind "mouse_y" "pitch"             // 鼠标垂直移动控制视角
bind "e" "+use"                    // 使用/互动
bind "r" "+reload"                 // 装填弹药
bind "f" "+lookatweapon"           // 检视
bind "space" "+jump"               // 跳跃
bind "ctrl" "+duck"                // 蹲下
bind "tab" "+showscores"           // 显示计分板
bind "g" "drop"                    // 丢弃物品
bind "m" "teammenu"                // 打开队伍选择菜单
bind "shift" "+sprint"             // 静步
bind "b" "buymenu"                 // 打开购买菜单
bind "1" "slot1"                   // 主武器
bind "2" "slot2"                   // 副武器
bind "3" "slot3"                   // 匕首
bind "4" "slot11"                  // 电击枪
bind "5" "slot5"                   // C4
bind "z" "slot6;"                  // 雷
bind "x" "slot7"                   // 闪
bind "c" "slot8"                   // 烟
bind "6" "slot9"                   // 诱饵弹
bind "v" "slot10"                  // 火
bind "q" "lastinv"                 // 切换到上一个武器
bind "y" "+spray_menu"             // 打开喷漆菜单
bind "i" "messagemode2"            // 打开团队聊天
bind "u" "messagemode"             // 打开全局聊天
bind "mouse4" "+voicerecord"       // 语音
bind "alt" "+radialradio"          // 快捷聊天轮盘
bind "ralt" "noclip"               // 飞行键
bind "mouse5" "player_ping"		   // 玩家标记
bind "mwheeldown" "+jump"          // 鼠标滚轮向下跳跃
bind "mwheelup" "+jump"            // 鼠标滚轮向上跳跃
bind "`" "toggleconsole"                           // 打开/关闭控制台
bind "t" "switchhands"                             // 切换武器持握方式（左手/右手）
bind "h" "toggleradarscale"                        // 切换雷达缩放比例
bind "n" "toggle cl_teamid_overhead_mode 1 3"      // 切换队友头顶标识模式
bind "'" "radio2;slot12"                           // 打开无线电菜单、X光显示、医疗针
bind "-" "toggle cl_draw_only_deathnotices 1 0"    // 切换是否仅显示死亡通知与准星
bind "=" "toggle cl_drawhud_force_radar 0 1"       // 切换是否强制显示雷达
bind "f1" "vote 1"                                 // 投票选择同意
bind "f2" "vote 2"                                 // 投票选择拒绝
bind "f5" "buy hegrenade"                          // 购买高爆手雷
bind "f6" "buy flashbang"                          // 购买闪光弹
bind "f7" "buy smokegrenade"                       // 购买烟雾弹
bind "f8" "buy molotov;buy incgrenade"             // 购买燃烧瓶/燃烧弹
bind "f9" "buy vest"                               // 购买防弹衣
bind "f10" "buy vesthelm"                          // 购买防弹衣+头盔
bind "f11" "buy defuser"                           // 购买拆弹器
bind "f4" "buy rifle1"                             // 购买主武器（步枪第二槽位）
bind "f3" "buy secondary4"                         // 购买副武器（手枪第五槽位）
bind "backspace" "sellbackall"                     // 出售所有已购买物品
bind "del" "toggle volume 0.10 1.00"               // 切换总音量为30%

没什么特别要说的，都是直意注释，将你的按键替换掉原来的按键即可。

飞行键当然只能在跑图作弊模式使用，请不要问我为什么竞技模式按了不能飞。

队友头顶显示、仅显示雷达、准星等功能可以到视频里观看效果。

购买主武器和副武器等功能，可以尽情发挥。这里我的游戏中步枪第二槽位放的AK、M4，手枪第五槽位放的沙鹰。

最后一个一键消音是死斗神器说是，避免枪声过大导致耳聋。

如果你希望使用游戏默认的4号键轮切投掷物，或者滚轮切换装备请自行使用：

bind "4" "slot4"
bind "mwheeldown" "invnext"
bind "mwheelup" "invprev"

需要注意的是，该套CFG中的4号键切换电击枪是强绑定的。如果你修改了4号键功能，并使用该套CFG(而不是单独使用autoexec)的话，需要删除exec zeus.cfg代码行或者删除zeus.cfg文件，否则你的4号键功能会异常。

联动CFG启动按键

exec zeus.cfg                                      // 默认启动，电击枪自动切换。
bind "o" "exec autoexec;"                          // 恢复默认准星与持枪视角
bind "j" "exec knife.cfg;"                         // 更换匕首模型
bind "p" "exec practice.cfg;"                         // 加载跑图预设
bind "[" "exec crosshair_view;"                    // 准星与持枪预设
bind "]" "exec demo_hlae.cfg;"                     // demo预设
bind "k" "say_team !drop"                          // 一键发刀(平台)
bind "\" "say_team .hp"                            // 伤害统计(5E平台)

看到的兄弟们有福了，虽然说是联动CFG，但我写文章时才发现把一键发刀和报伤害也写到这里了。

其实是很简单的功能了，你也可以随便写个比如一键暂停，对面掉人了卡投票(很恶意，不提倡)。

基础准星

crosshair true                                       // 启用准星
//──────────────────────  自定义准星替换区  ─────────────────────────────
cl_crosshair_drawoutline "false"                     // 禁用准星轮廓绘制
cl_crosshair_dynamic_maxdist_splitratio "0.300000"   // 动态准星最大分离距离的比例
cl_crosshair_dynamic_splitalpha_innermod "1.000000"  // 动态准星内部分离部分的透明度
cl_crosshair_dynamic_splitalpha_outermod "0.500000"  // 动态准星外部分离部分的透明度
cl_crosshair_dynamic_splitdist "7"                   // 动态准星分离距离
cl_crosshair_outlinethickness "1.000000"             // 准星轮廓的厚度（如果启用轮廓）
cl_crosshair_recoil "false"                          // 禁用准星随武器后坐力动态变化
cl_crosshair_t "false"                               // 禁用T形准星
cl_crosshairalpha "255"                              // 准星的透明度（255为完全不透明）
cl_crosshaircolor "5"                                // 准星颜色（5为自定义颜色）
cl_crosshaircolor_b "255"                            // 准星颜色的蓝色分量（RGB）
cl_crosshaircolor_g "255"                            // 准星颜色的绿色分量（RGB）
cl_crosshaircolor_r "255"                            // 准星颜色的红色分量（RGB）
cl_crosshairdot "false"                              // 禁用准星中心点
cl_crosshairgap "-3.400000"                          // 准星间隙大小（负值表示准星向内收缩）
cl_crosshairgap_useweaponvalue "false"               // 禁用根据武器调整准星间隙
cl_crosshairsize "0.900000"                          // 准星大小
cl_crosshairstyle "4"                                // 准星样式（4为经典静态准星）
cl_crosshairthickness "0.800000"                     // 准星线条的厚度
cl_crosshairusealpha "true"                          // 启用准星透明度设置
//───────────────────────────────────────────────────────────────────────────

唯一要说的也就crosshair true了吧，说来这是之前有位朋友玩游戏时发现没有准星，我告知它可能是这条命令参数被设置为了0(false)，故将此代码加入至该文件。

狙击镜准星

cl_crosshair_sniper_width "2"						 // 狙击镜准星线粗细
cl_sniper_show_inaccuracy 1                          // 狙击镜扩散开启

依旧直意。

投掷物准星

cl_grenadecrosshair_decoy 1               // 启用诱饵弹的投掷轨迹准星
cl_grenadecrosshair_explosive 1           // 启用爆炸物（如手雷）的投掷轨迹准星
cl_grenadecrosshair_fire 1                // 启用燃烧弹的投掷轨迹准星
cl_grenadecrosshair_flash 1               // 启用闪光弹的投掷轨迹准星
cl_grenadecrosshair_keepusercrosshair 1   // 投掷时保留玩家自定义准星
cl_grenadecrosshair_smoke 1               // 启用烟雾弹的投掷轨迹准星
cl_grenadecrosshairdelay_decoy "0.50"     // 设置诱饵弹投掷轨迹准星的延迟时间
cl_grenadecrosshairdelay_explosive "0.50" // 设置爆炸物投掷轨迹准星的延迟时间
cl_grenadecrosshairdelay_fire "0.50"      // 设置燃烧弹投掷轨迹准星的延迟时间
cl_grenadecrosshairdelay_flash "0.50"     // 设置闪光弹投掷轨迹准星的延迟时间
cl_grenadecrosshairdelay_smoke "0.50"     // 设置烟雾弹投掷轨迹准星的延迟时间

关键就是设置一个延迟时间吧，0.5是差不多拉完栓顿一下就会出现坐标轴准星了。

准星杂项

cl_observed_bot_crosshair 2               // 观察机器人时显示准星（2为始终显示）
cl_show_observer_crosshair 2              // 观察其他玩家时显示准星（2为始终显示）
cl_teamid_overhead_fade_near_crosshair "0.5" // 设置队友ID在准星附近时的淡出距离

直意。

持枪视角

viewmodel_fov 68                  // 设置视角模型（武器）的视野范围
viewmodel_offset_x 2              // 调整视角模型在X轴上的偏移（左右位置）
viewmodel_offset_y 2              // 调整视角模型在Y轴上的偏移（前后位置）
viewmodel_offset_z -1             // 调整视角模型在Z轴上的偏移（上下位置）
viewmodel_presetpos 0             // 预设的视角模型

直意。

雷达

cl_radar_always_centered "0"        // 雷达不居中，显示整个地图
cl_radar_scale "0.37"               // 设置雷达缩放比例为 0.37
cl_hud_radar_scale "1"              // 设置 HUD 雷达缩放比例为 1
cl_teammate_colors_show "2"         // 显示队友颜色为 2（默认颜色模式）
cl_radar_icon_scale_min "0.6"       // 设置雷达图标最小缩放比例为 0.6
cl_radar_rotate "1"                 // 雷达随玩家视角旋转
cl_radar_square_always 0            // 不强制方形小地图
cl_radar_square_with_scoreboard 1   // 计分板地图为方形

这个设置是所有地图都可以从小地图看到完整地图的，第一时间获取重要信息。

设置完整小地图是对单排玩家极其利好的，很多时候队友报点甚至不如自己看到的一手信息。

网络、延迟、帧数显示

cl_hud_telemetry_frametime_show 2  // 显示帧生成时间及FPS
cl_hud_telemetry_ping_show 2       // 显示延迟
mm_dedicated_search_maxping "70"   // 设置匹配时允许的最大 ping 值

依旧是直意。

匹配时最大ping值，如果你使用的加速器效果不好，但又在打国际服，可以把这个参数设置大一些，能让你匹配到除香港之外比如东南亚的玩家。

杂项

cl_prefer_lefthanded 0             // 右手持枪（默认）
cl_debounce_zoom 0                 // 按住开镜键持续切换
cl_silencer_mode 1                 // 开启卸下消音器
cl_use_opens_buy_menu "0"          // 关闭E键打开购买菜单
cl_dm_buyrandomweapons 0           // 关闭死斗随机买枪
cl_teamcounter_playercount_instead_of_avatars 1 // 显示上层对局存活数字(1)或者头像(0)
r_drawtracers_firstperson 1        // 显示曳光弹
r_fullscreen_gamma 2.6             // 设置亮度
cl_teamid_overhead_mode 3          // 隔墙显示队友位置
cl_teamid_overhead_colors_show 1   // 玩家ID上使用玩家颜色

直意。

快捷聊天轮盘

cl_radial_radio_tap_to_ping false  // 关闭“地图标记”功能
cl_radial_radio_tab 0              // 当前激活标签页：0（后续可通过操作切换1/2页）
cl_radial_radio_tab_0_text_1 #Chatwheel_grenade         // 第0页选项1：请求手雷
cl_radial_radio_tab_0_text_2 #Chatwheel_sniperspotted   // 第0页选项2：发现狙击手
cl_radial_radio_tab_0_text_3 #Chatwheel_fire            // 第0页选项3：开火指令
cl_radial_radio_tab_0_text_4 #Chatwheel_fallback        // 第0页选项4：撤退指令
cl_radial_radio_tab_0_text_5 #Chatwheel_smoke           // 第0页选项5：请求烟雾弹
cl_radial_radio_tab_0_text_6 #Chatwheel_gogogo          // 第0页选项6：进攻指令（冲！）
cl_radial_radio_tab_0_text_7 #Chatwheel_flashbang       // 第0页选项7：请求闪光弹
cl_radial_radio_tab_0_text_8 #Chatwheel_needbackup      // 第0页选项8：需要支援
cl_radial_radio_tab_1_text_1 #Chatwheel_requestweapon   // 第1页选项1：请求武器
cl_radial_radio_tab_1_text_2 #Chatwheel_requestspend    // 第1页选项2：请求经济支援
cl_radial_radio_tab_1_text_3 #Chatwheel_bplan           // 第1页选项3：B点战术计划
cl_radial_radio_tab_1_text_4 #Chatwheel_heardnoise      // 第1页选项4：听到动静（有声音）
cl_radial_radio_tab_1_text_5 #Chatwheel_midplan         // 第1页选项5：中路战术计划
cl_radial_radio_tab_1_text_6 #Chatwheel_ihavethebomb    // 第1页选项6：我持有炸弹
cl_radial_radio_tab_1_text_7 #Chatwheel_aplan           // 第1页选项7：A点战术计划
cl_radial_radio_tab_1_text_8 #Chatwheel_requestecoround // 第1页选项8：请求经济局（eco）
cl_radial_radio_tab_2_text_1 #Chatwheel_affirmative     // 第2页选项1：收到/同意
cl_radial_radio_tab_2_text_2 #Chatwheel_negative        // 第2页选项2：拒绝/不同意
cl_radial_radio_tab_2_text_3 #Chatwheel_compliment      // 第2页选项3：称赞（打得好）
cl_radial_radio_tab_2_text_4 #Chatwheel_thanks          // 第2页选项4：感谢
cl_radial_radio_tab_2_text_5 #Chatwheel_cheer           // 第2页选项5：加油/鼓舞
cl_radial_radio_tab_2_text_6 #Chatwheel_peptalk         // 第2页选项6：打气（稳住）
cl_radial_radio_tab_2_text_7 #Chatwheel_sorry           // 第2页选项7：抱歉
cl_radial_radio_tab_2_text_8 #Chatwheel_sectorclear     // 第2页选项8：区域安全

这里没有使用之前很火的轮盘切换道具瞄点(有点太折腾了，效果又不如你在实战中多丢几次，不过回味轮盘买装备倒是挺有趣)，而是直接用游戏内置的一些文本和图标，匹配游戏内置的语音信息。

这里你可以根据游戏中的效果，自行将#Chatwheel_fire等参数修改到你想要的位置。

声音

volume 1                              // 主音量
snd_headphone_eq 0                    // 均衡器
snd_menumusic_volume 0.03             // 主菜单音乐音量
snd_roundstart_volume 0               // 回合开始音量
snd_roundend_volume 0.02              // 回合结束音量
snd_roundaction_volume 0              // 回合开始行动音量
snd_mvp_volume 0.12                   // MVP音量
snd_mapobjective_volume 0.12          // 炸弹/人质音量
snd_tensecondwarning_volume 0.08      // 十秒警告音量
snd_deathcamera_volume 0.08           // 死亡视角音量
snd_mute_mvp_music_live_players 1     // 当双方团队成员都存活时关闭 MVP 音乐
snd_mute_losefocus 0                  // 后台播放声音
voice_modenable 1                     // 启用语音

直意。

HUD界面

hud_showtargetid "1"               // 显示队友/敌人的 ID
hud_scaling "0.85"                 // 设置 HUD 缩放比例
safezonex "0.88"                   // 设置 HUD 水平占比
safezoney "0.905"                  // 设置 HUD 竖直占比
cl_color "4"                       // 设置队伍中玩家颜色
cl_hud_color "0"                   // 设置 HUD 颜色
cl_showloadout "0"                 // 不总显示物品栏

HUD水平和竖直占比，在游戏中拉条(Bar)设置的话，是有极限的，但在控制台，你可以尽可能将HUD集中。我这里的设置是保守的，偏集中，而不是默认的抵住顶部底部边缘。

HUD颜色可以看下面的颜色代码，自行选择一个默认值，或者利用下面的代码定义别名，控制台输入别名进行更换，默认值0为灰白色。

不总显示物品栏就是你走路时不切换装备，就会隐藏掉主武器副武器和刀的右下角显示。

其他

con_enable "1"                     // 启用开发者控制台
fps_max 0                          // 帧率无上限
cl_join_advertise "2"              // 公开游戏会话
gameinstructor_enable "0"          // 禁用教学提示系统
cl_autohelp "false"                // 禁用自动帮助提示
func_break_max_pieces 0            // 可破坏物体破碎时最大碎片数
r_show_build_info 0                // 关闭版本信息
spec_replay_autostart 0            // 关闭被击杀回放

一些无人在意的小设置。

HUD颜色更改

alias "lwhite" "cl_hud_color 1;echo HUD更改为灰白色!"
alias "bwhite" "cl_hud_color 2;echo HUD更改为亮白色!"
alias "lblue" "cl_hud_color 3;echo HUD更改为浅蓝色!"
alias "blue" "cl_hud_color 4;echo HUD更改为深蓝色!"
alias "purple" "cl_hud_color 5;echo HUD更改为紫色!"
alias "red" "cl_hud_color 6;echo HUD更改为红色!"
alias "orange" "cl_hud_color 7;echo HUD更改为橙色!"
alias "yellow" "cl_hud_color 8;echo HUD更改为黄色!"
alias "green" "cl_hud_color 9;echo HUD更改为绿色!"
alias "cyan" "cl_hud_color 10;echo HUD更改为青绿色!"
alias "pink" "cl_hud_color 11;echo HUD更改为粉色!"

可以结合这里的颜色参数(1,2,3...)将上面HUD界面提到的cl_hud_color 0设置为你想要的颜色。

这里前边的别名(lwhite、bwhite)是在控制台输入时，即可执行后面的命令。

控制台功能别名绑定

alias "lefthand" "cl_prefer_lefthanded 1;echo 默认左手持枪!"
alias "debounce" "cl_debounce_zoom 1;echo 关闭连镜切换!"
alias "silencer" "cl_silencer_mode 0;echo 关闭卸下消音器!"
alias "avatars" "cl_teamcounter_playercount_instead_of_avatars 0;echo 显示对局头像!"
alias "numbers" "cl_teamcounter_playercount_instead_of_avatars 1;echo 显示对局数字!"
alias "tracer" "r_drawtracers_firstperson 0;echo 关闭曳光弹!"
alias "ping" "cl_radial_radio_tap_to_ping true;echo 快捷轮盘启用标点!"
alias "squareon" "cl_radar_square_always 1;echo 强制方形小地图!"
alias "squareoff" "cl_radar_square_always 0;echo 取消强制方形小地图!"
alias "round" "cl_radar_square_with_scoreboard 0;echo 计分板地图为圆形!"
alias "sniperon" "cl_sniper_show_inaccuracy 1;echo 已开启狙击镜扩散!"
alias "sniperoff" "cl_sniper_show_inaccuracy 0;echo 已关闭狙击镜扩散!"
alias "flyn" "bind "n" "noclip";bind "ralt" "toggle cl_teamid_overhead_mode 1 3";echo 已绑定"n"为飞行，"ralt"为队友标识切换！"
alias "flyralt" "bind "ralt" "noclip";bind "n" "toggle cl_teamid_overhead_mode 1 3";echo 已绑定"ralt"为飞行，"n"为队友标识切换！"
alias "ps" "cl_ticktiming print summary;echo 显示服务器tick信息!"
alias "pd" "cl_ticktiming print detail;echo 显示服务器tick详细信息!"
alias "show" "cl_showloadout 1;echo 常显装备栏!"
alias "notshow" "cl_showloadout 0;echo 取消常显装备栏!"

具体可见控制台导航的提示信息，这一部分是为了实现那里提到的功能。

准星、视角查询初始化

alias "whoamic" "echo 您还未启动准星视角预设CFG,请按']'键启动准星视角预设!"
alias "whoamiv" "echo 您还未启动准星视角预设CFG,请按']'键启动准星视角预设!"

这里需要搭配crosshair_view.cfg使用。单独使用autoexec则可以删掉这部分。

更新区

unbind F1                          // 取消自定义绑定F1
unbind F2                          // 取消自定义绑定F2

这里的两行是取消掉任何绑定的F1、F2功能，让它们回到本身的默认功能，也即同意或拒绝投票。原因是在2025.8.15更新后，平台投票功能，无法使用vote 1/2来实现，尚未知晓原因，故直接改为默认。

控制台导航

echo ══════════════════════════════════════════════════════════════════
echo       ____           ____             ____   _____    ____
echo      / ___|   _ __  |  _ \           / ___| |  ___|  / ___|
echo      \___ \  | '__| | |_) |  _____  | |     | |_    | |  _
echo       ___) | | |    |  __/  |_____| | |___  |  _|   | |_| |
echo      |____/  |_|    |_|              \____| |_|      \____|
echo ══════════════════════════════════════════════════════════════════
echo 文档地址：https://doc.srprolin.top/posts/SrP-CFG_CS2/srpcfg-1.html
echo autoexec Enabled!
echo ═════════════════════════════════════════════════════════════
echo ──────────────────────  更新报告  ─────────────────────────────
echo 2025.08.15更新后F1、F2默认绑定为投票，需要取消自定义绑定
echo ──────────────────────  HUD颜色更换  ─────────────────────────────
echo ·输入 lwhite → 灰白色 | cl_hud_color 1;
echo ·输入 bwhite → 亮白色   | cl_hud_color 2;
echo ·输入 lblue →  浅蓝色   | cl_hud_color 3;
echo ·输入 blue  →  蓝色   | cl_hud_color 4;
echo ·输入 purple → 紫色   | cl_hud_color 5;
echo ·输入 red   →  红色   | cl_hud_color 6;
echo ·输入 orange → 橙色   | cl_hud_color 7;
echo ·输入 yellow → 黄色   | cl_hud_color 8;
echo ·输入 green →  绿色   | cl_hud_color 9;
echo ·输入 cyan  →  青绿色   | cl_hud_color 10;
echo ·输入 pink  →  粉色   | cl_hud_color 11;
echo ──────────────────────  常用指令  ─────────────────────────────
echo ·输入 lefthand → 切换默认左手持枪 | cl_prefer_lefthanded 1;
echo ·输入 debounce → 关闭连镜切换         | cl_debounce_zoom 1;
echo ·输入 silencer → 禁用卸下消音器   | cl_silencer_mode 0;
echo ·输入 avatars → 显示对局头像      | cl_teamcounter_playercount_instead_of_avatars 0;
echo ·输入 numbers → 显示对局数字      | cl_teamcounter_playercount_instead_of_avatars 1;
echo ·输入 tracer → 关闭曳光弹         | r_drawtracers_firstperson 0;
echo ·输入 ping → 开启快捷轮盘标点     | cl_radial_radio_tap_to_ping true;
echo ·输入 squareon → 强制方形小地图     | cl_radar_square_always 1;
echo ·输入 squareoff → 取消强制方形小地图  | cl_radar_square_always 0;
echo ·输入 round → 计分板地图为圆形    | cl_radar_square_with_scoreboard 0;
echo ·输入 clear → 清除控制台           | clear;
echo ·输入 cvarlist → 显示所有控制台指令    | cvarlist;
echo ·输入 status → 显示steamID         | status;
echo ·输入 sniperon → 显示狙击镜扩散     | cl_sniper_show_inaccuracy 1;
echo ·输入 sniperoff → 关闭狙击镜扩散     | cl_sniper_show_inaccuracy 0;
echo ·输入 flyn → 开启n键飞行           | bind "n" "noclip";
echo ·输入 flyralt → 开启ralt键飞行      | bind "ralt" "noclip";
echo ·输入 ps → 显示当前游戏延迟总结      | cl_ticktiming print summary;
echo ·输入 pd → 显示当前游戏延迟详情      | cl_ticktiming print detail;
echo ·输入 show → 常显装备栏    			| cl_showloadout 1；
echo ·输入 notshow → 取消常显装备栏      | cl_showloadout 0；
echo ────快捷轮盘当前激活标签页：0（切换1/2页）  | cl_radial_radio_tab 0;
echo ───────────────────────  快捷键  ─────────────────────────────
echo ──── 重启autoexec  		    : O键 | exec autoexec
echo ──── 跑图,练习道具  			:  P键 | exec practice
echo ──── 更换匕首模型 			    :  J键 | exec knife
echo ──── demo观赛预设(含HLAE) 	     :  ]键 | exec demo_hlae
echo ──── 一键发刀(平台) 	        :  K键 | say_team !drop
echo ──── 一键伤害提示(5E平台)	    :  \键 | say_team .hp
echo ──── 准星与持枪视角预设         :  [键 | exec crosshair_view
echo ──── 切换雷达缩放比例           :  h键 | toggleradarscale
echo ──── 切换是否仅显示死亡通知与准星:  -键 | toggle cl_draw_only_deathnotices 1 0
echo ──── 切换是否强制显示雷达       :  =键 | toggle cl_drawhud_force_radar 1 0
echo ──── 快捷聊天轮盘              : alt键 | +radialradio
echo ──── 默认飞行键                : ralt键 | noclip
echo ──── 一键消音至30%  		    : delete键 | toggle volume 0.10 1.00
echo ──── 购买雷、闪、烟、火、半甲、全甲、钳 : F5|F6|F7|F8|F9|F9|F10|F11
echo ──── 出售所有已购买物品 		 : backspace键 | sellbackall
echo ──── 以下功能，在跑图模式下，产生按键冲突，后启动的模式按键优先：
echo ──── 切换队友头顶标识模式       : n键 toggle cl_teamid_overhead_mode 1 3
echo ═════════════════════════════════════════════════════════════

该写的都在导航中写了。

结语

这里希望大家根据本篇文章可以自己编写属于自己的CFG。

当然，你可以下载我的整套SrP-CFG使用，或者单独使用其中的autoexec.cfg。如果有需要，我可以帮助你修改autoexec.cfg适应你的需求，并在仓库中进行同步更新。

最后，这是我的项目地址SrP-CFG，希望有能力者可以给我一个免费的star⭐，感谢大家的支持。

如何安全地使用SSH、SFTP？

Fri, 07 Nov 2025 00:00:00 GMT

SSH 的基本概念

SSH的百科介绍中提到：

SSH 是较可靠，专为远程登录会话和其他网络服务提供安全性的协议。
SSH 客户端适用于多种平台。几乎所有 UNIX 平台—包括 HP-UX、Linux、AIX、Solaris、Digital UNIX、Irix，以及其他平台，都可运行 SSH。
SSH 有很多功能，它既可以代替 Telnet，又可以为 FTP、PoP、甚至为 PPP 提供一个安全的“通道” 。

SSH 的基本结构和使用场景：

SSH 是由客户端和服务端的软件组成的，有两个不兼容的版本分别是：1.x 和 2.x。用 SSH 2.x 的客户程序是不能连接到 SSH 1.x 的服务程序上去的。OpenSSH 2.x 同时支持 SSH 1.x 和 2.x。
服务端是一个守护进程(daemon)，他在后台运行并响应来自客户端的连接请求。服务端一般是 sshd 进程，提供了对远程连接的处理，一般包括公共密钥认证、密钥交换、对称密钥加密和非安全连接。
客户端包含 ssh 程序以及像 scp（远程拷贝）、slogin（远程登陆）、sftp（安全文件传输）等其他的应用程序。

简单来说就是用于连接远程服务器(多数为 Linux 系统)的一种加密通信方式；通常情况下，SSH 服务端运行在 22 端口上。

SSH 的安全验证方式

基于口令的安全验证只要你知道自己账号和口令，就可以登录到远程主机。所有传输的数据都会被加密，但是不能保证你正在连接的服务器就是你想连接的服务器。可能会有别的服务器在冒充真正的服务器，也就是受到“中间人”这种方式的攻击。
基于密匙的安全验证需要依靠密匙，也就是你必须为自己创建一对密匙，并把公用密匙放在需要访问的服务器上。如果你要连接到 SSH 服务器上，客户端软件就会向服务器发出请求，请求用你的密匙进行安全验证。服务器收到请求之后，先在该服务器上你的主目录下寻找你的公用密匙，然后把它和你发送过来的公用密匙进行比较。如果两个密匙一致，服务器就用公用密匙加密“质询”（challenge）并把它发送给客户端软件。客户端软件收到“质询”之后就可以用你的私人密匙解密再把它发送给服务器。

云服务器的 SSH 安全策略

本文中提到的 Linux 系统以Ubuntu24发行版为例。

基于上文提到的，SSH 服务端一般运行在 22 端口，大多数云服务器厂商的安全组都默认开放了该端口；因此“攻击者”们也都知道 22 端口为 SSH 连接端口，且 Linux 的超级管理员 root 用户名也是众所周知的：如果“攻击者”采取密码爆破方式取得 SSH 的登录权，那么这台服务器就与你无关了。

使用一般用户操作，必要时提权

使用云服务器厂商面板或其他 SSH 工具登录服务器：

ssh root@<your-server-ip> | <your-server-ip>为服务器公网 IP 地址，或者也可以使用域名
- root为登录用户，这里是超级管理员；随后将提示您输入密码(只会拾取您的键盘信息而不进行显示)，输入完毕回车即可。

创建一个普通用户，作为后续登录用户：

sudo useradd -m <username> | 其中<username>为自定义值，
- -m参数为自动创建用户家目录，路径为/home/<username>/

为新创建的用户设置密码：

sudo passwd <username>
- 密码的输入没有回显，输入完毕后回车确认。

上文中的命令前置sudo本质上是将当前命令提升权限至root组来执行，但我们的上述过程均为root用户操作，所以可加可不加；那么对于日常登录操作的普通用户，需要为其赋予sudo权限，以便于管理服务器。

为普通用户赋予sudo权限的方式有两种：

直接将用户添加到sudo用户组：

sudo usermod -aG sudo <username> | 其中-aG参数表示追加到指定组

编辑sudo配置文件(这里用 nano 编辑器)：

sudo nano /etc/sudoers
- 找到(使用方向键)root ALL=(ALL:ALL) ALL这一行，在其下一行添加<username> ALL=(ALL:ALL) ALL，随后Ctrl+X退出编辑器，在提示框中键入y保存修改，最后Enter确认。

现在我们就可以切换到这个拥有sudo权限的用户来进行服务器管理了：

su - <username>
sudo ls /root
- 这条命令用来展示root用户目录下的文件；如果正常显示，说明当前用户拥有sudo权限。

那么在下次登录服务器时，就可以使用该用户：

ssh <username>@<your-server-ip>

为用户添加密钥验证方式

上文中说到，登录 SSH 时，是需要指定一个登录用户的，那么也就是说 SSH 的验证是基于用户的。

对于我们(个人 PC，Windows 为例)使用 SSH 连接至远程服务器(Linux)这一方式中，远程服务器提供 ssh 服务端，而我们的个人 PC 是用的 ssh 客户端，因此我们需要在 Windows 上安装客户端；如果你已经使用专用的 ssh 软件(比如 Xshell、FinalShell)，那么它们的终端中都是安装好了 ssh 客户端的。

不过你也完全可以使用 Windows 自带终端Powershell来进行 ssh 连接，请先验证是否安装了 ssh 客户端：

ssh -V
- 输出版本号即表示已安装

对于 ssh 的客户端，是使用known_hosts文件来识别远程服务器的；对于 ssh 的服务端，使用authorized_keys文件来验证客户端连接。

下面将介绍如何进行密钥连接：

在 ssh 的客户端(windows)上，打开 powershell，申请密钥对：

ssh-keygen -t ed25519 -C "your_email@example.com" | 其中-C参数为添加注释
- 获取的密钥对文件将会在C:\Users(用户)\<your-username>\.ssh\路径下。

前往该路径，使用记事本打开id_ed25519.pub文件，复制其中的全部内容，用于上传至服务器。

使用上文中提到的普通用户登录服务器：

ssh <username>@<your-server-ip>

此时的路径即为<username>的家目录，需要在此处创建并进入.ssh文件夹：

mkdir .ssh
cd .ssh

之后创建并编辑authorized_keys文件来保存客户端公钥：

nano authorized_keys
- 将刚刚复制的公钥内容粘贴至此，快捷键Ctrl+Shift+V，随后保存，退出即可。

至此，在下次登录时，服务端可以无需密码即可验证成功；客户端会提示是否保存服务端信息至known_hosts文件，手动确认保存即可。

如果想要获得某一服务器的 ssh 客户端认证信息(即known_hosts中关于该服务器的信息)，请打开你的 powershell：

ssh-keyscan <your-server-ip>
- 保存输出的所有信息该信息常用于一些自动化部署中，避免因 ssh 登录需手动在客户端确认验证时造成宕机。

修改默认端口

首先，依旧是使用上文中提到的普通用户登录你的服务器：

ssh <username>@<your-server-ip>

前往 ssh 的配置文件目录(由于修改系统服务，此时我们切换为 root 用户方便操作)：

sudo su -
cd /etc/ssh
nano sshd_config
- 找到#Port 22改为Port 22，在其下方添加Port 2222即可让 ssh 服务同时在 22 和 2222 端口处开放连接。
- 注意如果服务器有 firewall 等防火墙组件，需要开放 2222 端口；如果是云服务器，需要去安全组中开放 2222 端口的 TCP 入规则。

随后更新 system 配置，并重启 ssh 服务：

systemctl daemon-reload
systemctl restart ssh

注意，在我的sshd_config中有如下字段：

# When systemd socket activation is used (the default), the socket
# configuration must be re-generated after changing Port, AddressFamily, or
# ListenAddress.
#
# For changes to take effect, run:
#
#   systemctl daemon-reload
#   systemctl restart ssh.socket

按照提示我的重启 ssh 服务命令为：

systemctl daemon-reload
systemctl restart ssh.socket
systemctl restart ssh

随后，新开一个终端，在连接服务器时添加-p参数：

ssh <username>@<your-server-ip> -p 2222

在上述连接成功后，可以返回到原终端，重新编辑配置文件：

nano sshd_config
- 将Port 22这一行删除，并前往云服务器安全组中，关闭 22 端口的 TCP 入规则。

至此，在后续使用到 ssh 的命令中，均需加入参数-p 2222，因为默认的 22 端口已经被关闭；如果你的 SSH 命令长时间未响应，请思考是否是该原因。

禁用 root 登录、密码登录

继上文内容，依旧使用 root 身份来修改 ssh 服务端配置来实现：

sudo su -
cd /etc/ssh
nano sshd_config
- 找到#PermitRootLogin yes，改为PermitRootLogin no，即可关闭 root 登录，若没找到请在文件末尾自行添加。
- 找到#PasswordAuthentication yes，改为PasswordAuthentication no，即可关闭密码登录，若没找到请在文件末尾自行添加。

SFTP 安全文件传输以及权限问题

不过对于PermitRootLoginroot 用户登录这条，当你使用一些SFTP文件管理工具软件时，请打开，这样才能以 root 身份登录，以便于浏览和管理整个服务器的文件；sudo权限只能在命令行临时提权，对于SFTP软件是无法使用的，你当然是不想在终端中使用nano编辑器来更改文件或上传文件的，不然你也不会使用SFTP软件。

请注意，如果在SFTP软件中为服务器添加新文件，因为你的登录名为 root，那么新创建的文件也是属于 root 的，如果想要将该文件或路径的所有者改为普通用户，请按以下操作：

sudo chown <username> <file> | <file>为文件名称
sudo chown -R <username> <folder>/ | <folder>为文件夹名称，-R参数代表递归操作

此时用普通用户查看目录中的权限，如果权限不完整可进行调整：

ll | 查看当前目录下所有文件、文件夹的类型、权限、链接数、所有者、所属组、大小、修改时间、名称
- 如果仅查看目录中的文件名，可以使用ls命令

这里对权限作简要说明：

drwxr-xr-x 4 root root 4096 Nov 7 12:59 ./；此时忽略第一个字母d，它表示这是一个目录；随后每三个字母都是一组权限标识，分别代表所有者、所属组、其他用户的权限；我们这里只用关心第一组权限标识，rwx代表可读(read)、可写(write)、可执行(execute)；使用-则表示无这项权限；在这个例子中也可以清晰的看到两个root，前一个表示该目录所有者，第二个表示该目录的所属组。

权限调整命令：

chmod -R u+rwx <folder>/ | 为所有者添加读写执行权
chmod g-w <file> | 为所属组其他用户移除写权限
chmod a+r <file> | 为所有人添加读权限
chmod -R u=rwx,o=x <folder>/ | 为所有者设置读写执行权，为其他用户设置只执行权限

至此你已经学会了如何使用 SSH 进行远程服务器连接、为 SSH 连接提供了一定的安全保障，并学习了有关 SFTP 安全文件传输权限的一些知识。

SrP-Sakura For Minecraft | 自用插件服务器

Mon, 13 Oct 2025 00:00:00 GMT

Wiki

该文章列写了SrP-Sakura的客户端和服务端所用的各种资源，详细的命令、按键功能、插件管理说明请到Wiki文档中查看:

The Wiki For SrP-Sakura | (一个用vitepress搭建的文档页)

SrP-Sakura 服务端

这并不是一个免费公开的公共服务器，如果你需要的是那样，请关闭该标签页。

这是一个自搭建的原版插件服务器的操作指南，用于记录服务器的搭建过程与功能，防止因时间而遗忘掉部分服务器细节。介于在写这篇指南时，服务器已经完善搭建了 2 个月，部分内容可能有误，但会进行持续更新。这篇文章中会介绍部分插件的简单使用和会遇到的问题，希望对你有所帮助。同时，我为该1.21.4版本整合了一个纯净生存包，它安装了一些mod、光影、资源包等；当然，这些mod基本为可客户端单独所用，以便避免与插件服产生冲突；因此它只会对原版生存进行优化辅助，不会更改任何原版游戏内容；资源包和光影将被默认正确加载；部分游戏设置和快捷键将被更改和公示，请详细阅读部分mod功能与快捷键指南，以便达到良好游玩效果。

开放范围

这并不是一个由公共服务器搭建的 Minecraft 游戏服，它仅搭建在我自己使用的设备上，因此它并不是 24h 开机，随我个人的意志开关服。服务器采用两种方案来提供网络地址：

内网地址(需联系本人加入内网)：lin.srprolin.top
外网地址(需联系本人开启服务器)：minecraft.srprolin.top

核心与版本

以1.21.4为主版本，以paper作为服务器核心，无任何外置资源包(后续可能考虑)，采用多种插件来建设服务器。

当然paper核心也不支持任何mod

下面是一些核心的下载地址：

Vanilla原版服务器核心，不支持插件和模组，只提供了一些游戏设置和原版权限组设置(但它也并不是客户端运行的那个游戏，部分客户端红石科技将在此处失效)。
Spigot老牌插件服务器核心，对原版游戏性能进行优化(一些红石科技的逻辑将被修改)，同时支持安装插件。
Paper原Spigot的一个分支，特点是在spigot基础上，支持对部分游戏特性进行自定义更改。
Fabric严格上说这是一个模组加载器，但其作为各种mod服务器的核心，本身并不支持插件，所以一般会用MCDReforged(一个服务器管理框架)来部署fabric模组服，它提供了外置插件(由插件仓库社区提供)，不与其他插件兼容。

服务器插件

插件资源的来源：

spigot一些基础性插件依赖库的来源
CurseForge
Modrith
Github

插件列表：

EssentialsX可以说是一个童年插件了，像有名的/back、/home、/tpa指令基本都来自这个插件。可见它是一个基础性的聚合大插件，我们将以此为基础构建插件生态。
LuckPerms是一个权限组管理插件，它也是在EssentialsX文档中被提名的姐妹花，用它管理权限的优势是可以在Web网页端可视化操作。
Multiverse又名多元宇宙旨在实现一台服务器，无限可能。它是大型服务器必不可少的一款插件，它能在原版服务器地图的基础上创建新的地图，并为新世界创建规则；同时其中的门户组件，又能为世界中构建出类似地狱门的传送门，而不必需要命令行来实现多世界传送。
WorldEdit又名创世神，是专为快速建造的模组，同时它也可以作为插件供服务器安装，能够支持WorldEdit的各种快速建造指令。
WorldGuard是一个老牌的世界保护插件，它能够直接在文件中写明对某一世界的规则更改，例如苦力怕的爆炸是否会破坏方块；同时，它也支持对多元宇宙所创建世界的规则更改；结合多元宇宙，和WorldGuard的区域规则定义，就可以成功建造一个有模有样的主城了。
Chunky是一个避免服务器卡顿的预渲染插件，它可以通过终端命令，自行预加载一定范围内的地图资源，这样避免了玩家在跑图时，由于服务器性能不足而导致的卡顿。
MiniMOTD能够更改服务器在多人游戏选项页面的显示效果。
TAB是对原版的TAB面板进行了优化，并显示更多信息，同时又能够在画面上常显示计分板，用来展示一些必要信息十分好用。
DecentHolograms是一款功能非常多样的全息图插件，提供多种功能和自定义选项，可以轻松创建独特的个性化全息图。通过用户友好的命令界面，您可以轻松创建和自定义全息图，而无需编辑任何配置文件。
Simple Voice Chat是一款语音聊天模组，也可以作为服务器插件使用，可以支持在游戏中组队麦克风通信。
SkinsRestorer是一款用于恢复离线模式服务器和网络皮肤的插件，让玩家只需输入一条命令即可更换皮肤。此外，SkinsRestorer 还支持在大型网络中缓存皮肤。
Infinite Villager Trading插件旨在增强您的 Minecraft 服务器，提供村民交易的即时补货功能。使用此插件，您可以轻松配置各种交易机制，以适应您的游戏风格。
MobsToEggs是一个趣味插件，可以用鸡蛋将生物进行捕捉，并转化为该生物蛋，请注意该行为是有概率的。
Graves是一个全功能轻量级死亡宝箱插件/玩家墓穴插件！它囊括了您所需的一切功能，甚至更多！同时兼具轻量级和高效性。
GSit可以让你坐在楼梯/椅子上，在地面上躺下、扑腾、旋转和爬行。
ImageFrame将图像加载到地图和物品展示框上;从 URL 加载图像;支持 PNG、JPEG、WEBP 和 GIF;以地图形式或直接在物品展示框中获取它们！（使用智能选择工具选择您的物品展示框！）;自动图像调整意味着您的图像不会被拉伸！
ItemframeSnipper是ImageFrame的一个拓展，它将剪刀的功能拓展为，剪切掉物品展示框的突出显示。
InteractiveChat有了这个插件，你就可以和朋友们展示你手中的物品、物品栏内容和末影箱内容了！
InteractionVisualizer有了这个插件，你就可以！在 GUI 中实时查看玩家放入工作台的物品！

插件依赖：

Vault是一个免费的开源 API 库，并且不需要额外代码；这个插件与之前的插件是具有强关联性的，只有安装了它才能完善它们的功能，例如基于EssentialsX的经济系统，LuckPerms的权限组显示等。
PlaceholderAPI顾名思义是一个占位符插件，也是TAB插件正常显示的基础，例如%player_name%的显示。
ProtocolLib 是一个允许对 Minecraft 协议进行读写访问的库，它的作用只是让其他插件能够正常运行。
Adventure旨在提供与聊天组件交互所需的核心库。

SrP-Sakura 客户端

该纯净生存辅助整合包下载地址在Wiki的附属整合包页中提供。

启动器推荐

强烈推荐由上海交通大学 Minecraft 社自主研发的开源启动器SJMC Launcher，简要功能见宣传视频页

进入下载页后，选择 portable 版本，便于管理。

在任意盘符处创建新文件夹，命名为SJMCL，再将下载好的文件放入其中，双击运行即可。

资源列表

模组：

Fabric API
Tweakeroo L_ALT+H自动切换鞘翅 L_ALT+X伪潜行 L_ALT+C灵魂出窍开启自动补货开启死亡坐标打印开启灵活放置，搭配L_CTRL和L_ALT使用
- MaLiLib
TweakerMore K+C调出面板 R_ALT+P安全挂机 L_ALT+G伪夜视
WI Zoom Z键开启
Sodium 钠
Xplus 游戏内输入法
- Kotlin
- cloth config api
- architectury api
Xplus 自动钓鱼
3D skin layer
Searchables 设置键位搜索
Searchables packs 资源包搜索框
Remove Reloading Screen 资源包重载移除锁定
ScalableLux 优化
sodium options 钠视频画面
sodium extra 钠扩展
mod menu
- text placeholder api
Modern ui
- forge config api port
mini hud
lithium 狸优化
Custom lan 自定义联机
klee slabs 更好半砖破坏
- balm
jade 玉显示
iris shaders 光影管理
ice berg 冰山优化
item hightlighter 物品拾取高亮
fps reducer 限制器
euphoria patches 配合光影 ComplementaryUnbound 的插件
enity culting 实体渲染优化
detail armor bar 细节盔甲显示
detail armor bar compat 舒适显示
controlling 键位冲突显示
continuity 连接纹理（资源包启用）
chunks fade in 区块淡入动画
chat heads 聊天头像显示
chat patches 聊天补丁
- YetAnotherConfigLib
better advancements 更好的成就
better ping display 更好的延迟显示
betterstats 更好的统计信息
- TCDCommons API
better mount hud 更好骑乘显示
better f3 更卡的 f3（不是）
apple skin 苹果皮显示
ayame paperdoll 像基岩版的自我显示
simple voice chat 简单聊天
inventoryhud+ HUD 显示
Inventory profiles next 一键整理 R+C开启设置
- libIpn
lamb dynamic lights 动态光源
litematica 投影
- M+C打开设置
litematica printer 投影打印机
replay mod 回放
rei 物品管理器
trial spawner timer 试炼塔倒计时
ydm 武器大师
worldedit 创世神
xaero 世界地图
xaero 小地图
xaero plus
Bobby 服务器区块缓存
carpet 地毯假人模组
EMF entity 实体渲染
- ETF
- ESF

资源包：

Fresh 系列
- Fresh Animations
- Fresh moves
- Fresh Animations extensions
- Fresh Skeleton Physics
- Fresh Dungeons
- Fresh compats
- Fresh Animations details
- Fresh Animations objects
- Fresh Animations Emissive
Fresh Flower Pots
low fire
low on fire
low shield
masa mod translation pack
mob creates
XK redstone display
better lanterns
better bows
better boat

光影:

ComplementaryUnbound (已安装 euphoria patches，请不要卸载原光影)

一些Markdown语法展示

Sat, 26 Jul 2025 00:00:00 GMT

一级标题

二级标题

# 一级标题

## 二级标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

粗体粗体

**粗体**
**粗体**

斜体斜体

_斜体_
_斜体_

粗斜体 粗斜体

**_粗斜体_**
**_粗斜体_**

项目 1
项目 2

项目 3
- 子项目

项目 4
项目 5

- 项目 1
- 项目 2

* 项目 3
  - 子项目

- 项目 4
- 项目 5

列表 1 子列表
列表 2
列表 3

1. 列表 1
   子列表
2. 列表 2
3. 列表 3

~~中划线~~

~~中划线~~

[ ] 复选框（未完成）
- [ ] 子任务复选框

[x] 复选框（已完成）

- [ ] 复选框（未完成）
  - [ ] 子任务复选框

* [x] 复选框（已完成）

外链

[外链](https://obsidian.md/)

这是一条有变量的链接

[这是一条有变量的链接][这里是变量名]

[这里是变量名]: https://obsidian.md/

![图片链接](https://obsidian.md/apple-touch-icon.png)

![这是一条有变量的图片][图片变量名]

[图片变量名]: https://obsidian.md/apple-touch-icon.png

上下各有一条分割线（各一行）

---
上下各有一条分割线（各一行）
---

下面还是一条分割线（占三行）

下面还是一条分割线（占三行）

---

依旧是三条分割线（各一行）

依旧是三条分割线（各一行）

---

---

---

hello,world! 这是一个代码块
这是换行后的代码

    hello,world! 这是一个代码块
    这是换行后的代码

	printf("hello,world!"); //这还是一个代码块

上面代码块的实现： ```c printf("hello,world!"); //这还是一个代码块 ```

引用单段代码：hello,world!

引用单段代码：`hello,world!`

转义符\：这是一个双反斜杠\\

转义符`\`：这是一个双反斜杠\\\

这是一段引用文本

这是换行的第二段引用

这是组合引用第一行这是组合引用第二行

这是嵌套引用外层

这是嵌套引用内层

> 这是一段引用文本

    这是换行的第二段引用

> 这是组合引用第一行
> 这是组合引用第二行

> 这是嵌套引用外层
>
> > 这是嵌套引用内层

表头 1	表头 2	表头 3
表体 1	表体 2	表体 3
表体 4	表体 5	表体 6

上面是无对齐，下面是左中右对齐

表头 1	表头 2	表头 3
表体 1	表体 2	表体 3
表体 4	表体 5	表体 6

| 表头 1 | 表头 2 | 表头 3 |
| ------ | ------ | ------ |
| 表体 1 | 表体 2 | 表体 3 |
| 表体 4 | 表体 5 | 表体 6 |

上面是无对齐，下面是左中右对齐

| 表头 1 | 表头 2 | 表头 3 |
| :----- | :----: | -----: |
| 表体 1 | 表体 2 | 表体 3 |
| 表体 4 | 表体 5 | 表体 6 |

<u>HTML 下划线</u>

HTMLimg标签让照片变大：

<hr>为这段内容上方添加分割线</hr>

<span style="color: orange">使用 css 改变字体颜色</span>

<img style="width: 300px" src="https://obsidian.md/apple-touch-icon.png">

<hr>为这段内容上方添加分割线</hr>

<span style="color: orange">使用 css 改变字体颜色</span>

这里有两个视频：

</iframe>

<iframe
    src="https://player.bilibili.com/player.html?isOutside=true&aid=80433022&bvid=BV1GJ411x7h7&cid=137649199&p=0"
    scrolling="no"
    border="0"
    frameborder="no"
    framespacing="0"
    allowfullscreen="true"
    width="640"
    height="480"
></iframe>

<iframe
	width="560"
	height="315"
	src="https://www.youtube.com/embed/dQw4w9WgXcQ?si=SrfdRfdqp2FJyQTn" title="YouTube video player"
	 frameborder="0"
	 allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
	 referrerpolicy="strict-origin-when-cross-origin"
	 allowfullscreen>
</iframe>

$$ x+y=0 $$

这是一条公式 $x+y=1$

这是一个分数 $\frac{1}{2}$

这是一个根式 $\sqrt{2}$

这是一个 3 次根式 $\sqrt[3]{2}$

变量 $x_3$ 的平方为 $x^2_3$

变量 $y_{x_1}$ 的 $z_2$ 次方为 $y^{z_2}_{x_1}$

这是一个定积分 $\int_1^2xdx$

这是一个极限 $\lim_{n\rightarrow+\infty}\frac{1}{n + 1}$

这是一个向量 $\vec{a}$

这是一个算式 $1+2+3+\cdots+n$

这是一个范围 $1,2,3\ldots,n$

这是向量点乘 $\vec{a}\cdot\vec{b}$

这是从 1 至 n 的累加 $\sum_1^n$

$$
x+y=0
$$

这是一条公式 $x+y=1$

这是一个分数 $\frac{1}{2}$

这是一个根式 $\sqrt{2}$

这是一个 3 次根式 $\sqrt[3]{2}$

变量 $x_3$ 的平方为 $x^2_3$

变量 $y_{x_1}$ 的 $z_2$ 次方为 $y^{z_2}_{x_1}$

这是一个定积分 $\int_1^2xdx$

这是一个极限 $\lim_{n\rightarrow+\infty}\frac{1}{n + 1}$

这是一个向量 $\vec{a}$

这是一个算式 $1+2+3+\cdots+n$

这是一个范围 $1,2,3\ldots,n$

这是向量点乘 $\vec{a}\cdot\vec{b}$

这是从 1 至 n 的累加 $\sum_1^n$

这是亿些数学符号

代码	符号	描述
\not=	$\not=$	不等于
\approx	$\approx$	约等于
\times	$\times$	乘号
\div	$\div$	除号
\leq	$\leq$	小于等于
\geq	$\geq$	大于等于
\pm	$\pm$	正负号
\sum	$\sum$	求和符号（累加）
\prod	$\prod$	累乘
\coprod	$\coprod$	累除
\overline{a + b + c}	$\overline{a + b + c}$	平均值
\sin	$\sin$	正弦
\cos	$\cos$	余弦
\tan	$\tan$	正切
\cot	$\cot$	余切
\sec	$\sec$	正割
\csc	$\csc$	余割
\circ	$\circ$	度
\infty	$\infty$	无穷
\int	$\int$	定积分
\iint	$\iint$	双重积分
\iiint	$\iiint$	三重积分
\oint	$\oint$	曲线积分
x\prime	$x\prime$	求导
\lim	$\lim$	极限
\alpha	$\alpha$	阿尔法
\beta	$\beta$	贝塔
\gamma	$\gamma$	伽玛
\delta	$\delta$	德尔塔
\epsilon	$\epsilon$	艾普西龙
\eta	$\eta$	依塔
\theta	$\theta$	西塔
\pi	$\pi$	派
\omega	$\omega$	殴米伽
\rho	$\rho$	柔
\sigma	$\sigma$	西格玛
\mu	$\mu$	缪
\lambda	$\lambda$	拦姆达
\tau	$\tau$	滔
\psi	$\psi$	普赛
\phi	$\phi$	傅艾
\xi	$\xi$	柯西
\emptyset	$\emptyset$	空集
\in	$\in$	属于
\notin	$\notin$	不属于
\supset	$\supset$	真包含
\supseteq	$\supseteq$	包含
\bigcap	$\bigcap$	交集
\bigcup	$\bigcup$	并集
\log	$\log$	对数函数
\ln	$\ln$	以 e 为底的对数函数
\lg	$\lg$	以 10 为底的对数函数

略知OBS | 开源视频录制与直播推流

Fri, 25 Jul 2025 00:00:00 GMT

前言与摘要

首先，OBS的功能是非常强大的，可以用于直播推流、视频录制、即时回放、多机位画面切换。另外其自带的虚拟摄像机可以将准备好的画面，作为伪装好的摄像头画面在通讯软件中输出。其次，OBS作为开源软件，具有庞大的插件社区和脚本数量，使用OBS丰富的插件可以实现非常多的功能，而编写脚本可以实现自定义功能。本篇主要介绍OBS的下载、录制与直播设置、虚拟摄像头的使用案例、及时回放的设置、好用的插件教程。

下载与手册

官网下载地址: https://obsproject.com/download ，选择对应系统和方式下载。如果打不开，这里提供下载链接：

Windows：OBS-Studio-31.1.1-Windows-x64-Installer.exe
MacOS：obs-studio-31.1.1-macos-intel.dmg
Linux：下载：flatpak install flathub com.obsproject.Studio 运行：flatpak run com.obsproject.Studio
官方的帮助页面(全英)：Knowledge Base

快速开始

录屏基础设置

进入设置，点击左侧视频，设置基础(画布)分辨率为你想要录制的分辨率，默认推荐1920×1080；选择帧率，推荐为30帧或60帧。
点击输出，选择输出模式为高级，点击录制选项：设置你的录像路径、选择录像格式为MPEG-4(.mp4)；选择音频编码器为FFmpeg AAC。
选择视频编码器为x264或QuickSync H.264或NVIDIA NVENC H.264或AMD HW H.264(AVC)，如果存在多个，后两个更优，其次为第二个。
将上述编码器的设置中，比特率控制分别对应设置为CRF、CQP、恒定QP、恒定QP，并将值设置为20。
返回主页面，添加源，请选择显示器采集，随后自定义名称；然后选择你的显示器，确保画布中出现了显示器的画面；如果画布中显示不完全，请选择对应源右击，进行变换。至此，可以进行正常的录制屏幕了。
在添加源选项中，推荐更多的使用“窗口采集”，可以管理不同的图层表现，是比较灵活的选择。后面的详解配置将以此作为基础，进行优化和不同用法的介绍。

混音器与录音预设

当在“源”处选择，添加“应用程序音频”，或者添加“窗口采集”时勾选“音频采集功能”，那么均可在混音器中发现，并可在高级音频选项里选择音轨，最多6条独立音轨。想要录制多条音轨，需要在输出录制中勾选你想要输出的音轨及数量，推荐使用mkv格式封装在这种情况下，如果你需要录制实况视频，你可能会有私人语音、BGM、游戏声音、个人麦克风等多种声音，在后期剪辑时，可以做到特定音频分离，从而只获得干净的游戏声音。

需要注意的是，推荐将所有“源”都分给1号音轨，再开一条用于分离，原因有二：首先，默认的视频播放器对于多音轨视频会默认应用第一条音轨，这样在回看时可以获取所有的声音；其次，对于直播和录制场景不分离的用户，直播输出是只能一条音轨的，那么这个时候就可以在直播时勾选一号音轨，从而不用新建场景、新建源等操作。

音频的录制，想要获得更好的效果，需要对音频编码器、音频码率、音频采样进行设置：现在的音频设备，能够做到PCM24位的解析，应该是相当小众了，对于只是想进一步提升音频效果，我认为FLAC16位已经足够。音频码率，可以对每条音轨单独设置，单位是kbps，推荐192起步。采样率48kHz和44.1kHz均可；声道请不要选择单声道，他并不是“单声道”，他是将两只耳朵里的声音设置成一模一样的，推荐“立体声”，也即“双声道”，能够更好还原音频本来的空间效果。

视频编码器的使用场景

x264：此编码器为CPU编码，如果追求高质量的教程视频，对于CPU负担不重的场景，可以选用该编码器，它非常慢，但效果很好，不过一般有显卡就不要用这个了，显卡中有单独的编码单元就是为视频编码所设计的，而CPU，他只是能做这件事，但他要做的事情非常多。
QuickSync：这是IntelCPU的集成显卡的独立视频编码器，现在多数的游戏笔记本有两个显卡，一个称为独显，另一个称为核显，而这个就是核显，它可能会对CPU的性能有一定影响，如果确定不使用，可以选择禁用该显卡，只需要在Windows搜索栏搜索“设备管理器”，按照图示操作即可。
NVENC：这是NVIDIA显卡的视频编码器，一般情况下的录屏都可以使用该编码器，显卡的性能在多数情况下都是盈余的。但需要注意，在一些大型3A单机游戏、深度学习模型训练的场景下，显卡占用会被拉满，虽然视频编码器是被隔离开的，但这种情况下的录屏效果一般不会太好，推荐使用核显来录制，但同时，对于共享GPU内存会有占用，也会影响使用独显的应用性能表现。
HW：AMD显卡的视频编码器，你不会既有A卡又有N卡吧？那么你会是双机推流的用户，但如果不是迫不得已，N卡的适用场景还是远超A卡，但AMD的CPU是真的比Intel香。
编码器的后缀h.264是最常见的编码格式，在某些场景下，h.264可以是mp4的代称，虽然混淆，但是足够经典；h.265和hevc都是NVIDIA提出的新型编码格式，他是对h.264的一种优化，在追求高质量的同时缩小文件大小，同时也是直播常用的编码格式，可惜bilibili仍然不支持h.265直播，；AV1也是NVIDIA推出的新编码格式，可以认为是效果最好的一种格式了，但因为比较新，很多视频播放器并不支持，h.265也有很多情况下不是被默认支持的。

总之，优先选择NVENC和h.264在大多数场景下是不会错的。

需要注意的是，独显或集显的录制选择，需要看CPU、GPU的使用率，如果GPU已经要吃满了，那么集显的录制是比较优的。

现在大多聊天软件自带的视频预览播放器，仅支持h.264,如果只是单纯录屏分享，还是推荐h.264。

直播设置(bilibili为例)

这里是哔哩哔哩直播姬，在bilibili更新后，网页推流需要一定的粉丝基础才能开播，所以选择用直播姬，但本质上还是用的obs来直播。

复制服务器和推流码，接着打开obs：将服务器和推流码填入即可，此时obs会代理直播姬，在obs选择开播与下播。

接下来是直播的输出设置：

如果直播和录制场景不分离，音轨就要选择上文提到的1号音轨；
对于bilibili直播，选择h.264编码格式，独显和集显的使用按需选择，默认用独显；
音频编码器选择AAC；
比特率设置选择CBR，码率8000kbps起步，但其实已经够用，如果设置过高，主播需要更大的上行带宽来传输画面，观众也需要更高的下行带宽来下载画面，清晰度与流畅度的均衡，在超高码率情况下的性价比并不高。
关键帧间隔，很多直播平台会要求2s，这里的间隔时间越短，文件越大，但是后期剪辑越流畅，对于录制而言。
预设：根据obs的显示，越高质量对于编码器的性能要求越高，但视频文件越小，如果直播时略感吃力，可以调低预设。
调节：默认即可。
多次编码：二次编码1/4即可，均衡的选择。
配置文件：默认用high。
B帧：数字越大，文件越小，但会影响质量，有的直播平台会要求2，视频录制也可参考。

额外小功能与插件

虚拟摄像头

现在的OBS软件，已经内置了虚拟摄像头，以前是需要独立安装的，简单来说，就是将你的画布画面，作为摄像头采集的画面，输出给各种通话软件中，常见的就是腾讯会议。

而OBS本身就可以添加“摄像头”源，这时虚拟摄像头就是个二级输出，你可以为你本身的摄像头添加额外图层，用于遮挡、背景替换、添加注释信息等，将这些集成了信息的摄像头画面，通过虚拟摄像头发送给会议。腾讯会议的默认共享屏幕，只能单独程序的输出，如果全屏，会在展示者显示器上显示边框，影响体验，这时可以用OBS的外接源“虚拟摄像头” 这里就可以设置“虚拟摄像头”了，可以看到背景已经是OBS里的壁纸画面了，但他被认为是“摄像头”捕捉的视频。

回放缓存（及时回放）

这里的回放缓存，是用的视频输出的设置，最大内存请依照时间和编码设置进行调整。

这个回放缓存是可以完全做到NVIDIA的及时回放效果的，可以设置快捷键，也可以用插件实现同NVIDIA一样的通知提示。需要注意的是，启用回放缓存后，才能保存回放。这是当然的，挺废话的，但是我就经常在打游戏前忘记开启回放缓存，哈哈😄。

notifier插件

一款OBS指令操作提示的软件，基于WebSocket，仓库地址下载完成后，在OBS的WebSocket服务器处，获取地址和密码：在工具->WebSocket中，打开服务器，勾选身份认证，生成密码，点击“显示连接信息”复制密码。

启动OBS Notifier，如图所示填写地址：随后点击开始连接，可在obs处查看连接是否成功。

点击“从OBS开始”勾选“退出OBS退出程序”，就可以和OBS同步了，将其融为一体。

在通知样式中选择“Nvidia样式”，就可以得到和NVIDIA一模一样的通知风格了，并且它是显示在显示器上的，理论上不会被任何全屏应用覆盖。

虽然这样做到了和NVIDIA一模一样的及时回放效果，但OBS程序只要启用，他就会占用一部分的GPU性能，而NVIDIA录制几乎是没有性能损失的，所以并不是能够替代NVIDIA的及时回放，但他拥有高度自定义录制，这是一项独特的优势，不同的应用场景应有不同的取舍。

略知Zerotier | 搭建虚拟局域网

Fri, 18 Jul 2025 00:00:00 GMT

使用场景与前言

构建虚拟局域网，主要是为了内网之间的设备互相访问。在一般的家庭网络中，设备联网会经过同一个路由转发，此时的设备就在同一局域网中。举个例子，如果连接了同一个 WIFI，那么就可以在 Minecraft 多人游戏中自动显示局域网世界了。搭建虚拟局域网，一般是为了异地组网，而又没有公网 IP的情况。简单来说，拥有公网 IP的设备，可以被任何设备通过 IP 地址找到。 公网 IP又分为IPv4和IPv6。其中IPv4目前已经耗尽，其地址数量只有 2³² 个，地址格式为 32 位二进制，分为 4 组显示为点分十进制，例如：192.168.1.1；IPv6地址数量有 2¹²⁸，几乎趋近无限，地址格式为 128 位二进制，分为 8 组，显示为冒分十六进制，例如：2001:0db8:85a3:0000:0000:8a2e:0370:7334。从安全性、路由效率和使用配置上，目前IPv6都比IPv4更具优势。如果你拥有公网 IP，且安全性要求不是太大，组建虚拟局域网会显得多余。但是虚拟局域网之间的设备是可以互相访问的，而在公网中，设备只能访问拥有公网 IP的设备。举个例子，你在个人 PC 上的 25565 端口部署了一个服务，可以是一个 Minecraft 服务器，此时用你的这台 PC 访问该服务器，地址为192.168.1.1:25565或localhost:25565或127.0.0.1:25565，这三种都可以理解为本地地址，如果你的小伙伴想要进入这个服务器，显然这三种地址都不可行。如果你拥有公网 IP，那么他们的访问地址为(公网IP):25565；如果你搭建了虚拟局域网，那么访问地址为(虚拟局域网IP):25565。

Zerotier 的基本框架

首先，zerotier 由三部分组成：节点、根服务器、节点网络控制器

节点：我们安装 zerotier 的设备，都会被分配一个十位 ID，此时我们的设备就是 zerotier 中的节点。
根服务器：zerotier 官方的根服务器叫做 planet，节点的 ID 是由根服务器分配的，在整个框架中起到中转桥梁作用。
节点网络控制器：用于创建网络，让各个节点设备通过 planet 加入到该网络，对各个节点进行授权，使得各个节点之间互相访问。授权过后，各个节点会得到该网络的 ID 标识被被分配的虚拟 IP 地址。 zerotier 官方提供的控制器是与 planet 根服务器直连的，如果控制器创建了一个网络，那么 planet 也会得到该网络的 ID 标识，并得到节点被分配的虚拟 IP 地址。节点之间的首次连接，也是需要 planet 来做中间人，找到对应设备，并尝试加密直连。如果无法直连，流量则会经过 planet 来中转。
在安装 zerotier 后，UI 中体现的节点 ID (该 ID 可以进行更改)：
访问官方提供的节点网络控制器

Zerotier 的下载与使用

我们使用的工具是 ZeroTier 一个专门用来建立点对点虚拟专用网(P2P VPN)

以 Windows 系统为例

下载地址：https://www.zerotier.com/

点击 Download

一般情况下直接点击 MSI Installer (x86/x64) 下载完成如图

安装前请把 杀毒软件 全部关闭，尽量不要出现被拦截的情况。
双击进行安装后，在右下角托盘处，你会看到如图图标。

回到 ZeroTier 官网：https://www.zerotier.com/
选择 Sign Up 注册一个账号，然后 Log In 登录

Create A Network，点击进一个 Network 中

复制 Network ID 给你的朋友

等待朋友发来请求，下拉找到请求，勾选

点击托盘图标，点击 Join New Network

将代码输入，点击 Join

等待创建者同意加入网络

Zerotier 的自托管服务

详细内容，请参考官方文档 zerotier 提供的自托管服务有节点网络控制器和根服务器 首先，节点网络控制器自建，主要是为了安全性和突破节点设备限制。而根服务器自建，这里主要是自建moon 根服务器，而非planet。简单地说，任意一个节点他都可以充当节点网络控制器，只不过官方没有提供 webUI，需要部署第三方的。而moon 根服务器本质上是根服务器，作用与planet是相同的，主要因为planet是部署在国外的，高标识的大流量经过会遭到长城防火墙的拦截，导致连接失败，因此planet如果作为中转流量的服务器，在 IPv4 环境下，基本不太行得通，这时候就需要搭建在国内的moon做中转了。
moon 根服务器：(每个节点需要手动加入 moon 服务器)作为根服务器，基础作用就是用来识别节点 ID，并让节点设备之间互相建立连接的。但由于虚拟局域网的 IP 地址是由节点网络控制器授权后发放的，如果节点不能与 planet 进行连接，自然也无法通过 planet 来连接到官方的节点网络控制器，进而节点之间无法正常连接，moon 服务器的作用也被抹除。这时就需要自建节点网络控制器，并加入 moon 根服务器，通过自建的节点网络控制器来为节点分配虚拟 IP。至此，会发现这就相当于自建了一整个 zerotier，只不过 moon 服务器是需要手动加入的。

moon 根服务器的建立与加入

首先，自建 moon 服务器，需要一台拥有公网 IP 的设备，这里推荐用 Linux 云服务器，以此为例。具体教程查看官方文档。与云服务器建立 ssh 连接后，简要操作步骤如下： 0. 前往云服务器厂商的管理后台，开放服务器的 9993UDP 端口，以便 zerotier 服务正常运行。

执行curl -s https://install.zerotier.com | sudo bash或者sudo apt-get install zerotier-one命令，安装 zerotier。此时在命令窗里会显示当前设备的节点 ID。
执行cd /var/lib/zerotier-one进入 zerotier 的配置文件夹
执行zerotier-idtool initmoon identity.public >>moon.json命令，导出 moon 配置文件。
执行nano moon.json命令，使用 nano 编辑器编辑配置文件。

{
      "id": "deadbeef00",
      "objtype": "world",
      "roots": [
        {
          "identity": "deadbeef00:0:34031483094...",
          "stableEndpoints": ["10.0.0.2/9993","2001:abcd:abcd::1/9993"]
        }
      ],
      "signingKey": "b324d84cec708d1b51d5ac03e75afba501a12e2124705ec34a614bf8f9b2c800f44d9824ad3ab2e3da1ac52ecb39ac052ce3f54e58d8944b52632eb6d671d0e0",
      "signingKey_SECRET": "ffc5dd0b2baf1c9b220d1c9cb39633f9e2151cf350a6d0e67c913f8952bafaf3671d2226388e1406e7670dc645851bf7d3643da701fd4599fedb9914c3918db3",
      "updatesMustBeSignedBy": "b324d84cec708d1b51d5ac03e75afba501a12e2124705ec34a614bf8f9b2c800f44d9824ad3ab2e3da1ac52ecb39ac052ce3f54e58d8944b52632eb6d671d0e0",
      "worldType": "moon"
    }

在上述配置样例中，ID 应显示为你被分配的节点 ID；主要修改stableEndpoints里的内容，更改 IP 为该服务器的公网 IP，如果有 IPv6，可如实更改，没有则不填写，把它删掉。按照样例，没有的 IPv6 情况为"stableEndpoints": ["公网IP/9993"].
nano 编辑器的使用注意：完成编辑后，ctrl+x退出编辑器，命令窗提示是否保存，Y确定，最后Enter回车键，返回命令行。

执行zerotier-idtool genmoon moon.json命令，生成000000deadbeef00.moon文件，其中deadbeef00应为你的服务器被分配的节点 ID。
执行mkdir /var/lib/zerotier-one/moons.d在配置文件夹下创建moons.d文件夹，用于保存 moon 文件。此后执行cp 000000deadbeef00.moon ./moons.d/将生成的 moon 文件保存于moods.d文件夹下。
执行systemctl restart zerotier-one重启 zerotier 服务，至此，moon 服务器创建完成。
通过命令行加入 moon 服务器：在另一台想要加入 moon 服务器的设备上，执行zerotier-cli orbit deadbeef00 deadbeef00,其中deadbeef00应为 moon 服务器的节点 ID，此处仅为样例。然后执行systemctl restart zerotier-one.service重启 zerotier 服务，
通过 moon 文件计入 moon 服务器：将 moon 服务器产生的000000deadbeef00.moon文件 copy 到对应系统的配置文件夹中。

Linux:/var/lib/zerotier-one/moons.d/
Windows:C:\ProgramData\ZeroTier\One\moons.d\
MacOS:/Library/Application Support/ZeroTier/One/zerotier-one/moons.d/

通过 ztncui 自建节点网络控制器

详细教程参考官方文档此处以 Ubuntu 系统为例进行安装。

执行curl -O https://s3-us-west-1.amazonaws.com/key-networks/deb/ztncui/1/x86_64/ztncui_0.8.14_amd64.deb命令，从 AWS S3 存储桶下载 ZTNCUI 0.8.14 版本的.deb 安装包。
执行apt install ./ztncui_0.8.14_amd64.deb命令，使用 apt 包管理器安装下载的 ZTNCUI 包。
在云服务器厂商处开放 3443TCP 端口。
执行sh -c "echo ZT_TOKEN=`sudo cat /var/lib/zerotier-one/authtoken.secret` > /opt/key-networks/ztncui/.env"命令，将 ZeroTier 的认证令牌写入 ZTNCUI 的环境配置文件。
执行sh -c "echo HTTPS_PORT=3443 >> /opt/key-networks/ztncui/.env"命令，配置 ZTNCUI 监听 HTTPS 的端口为 3443。
执行sh -c "echo NODE_ENV=production >> /opt/key-networks/ztncui/.env"命令，设置 Node.js 应用为生产环境，优化性能和安全性。
执行chmod 400 /opt/key-networks/ztncui/.env命令，限制.env 文件仅所有者可读（防止敏感信息泄露）。
执行chown ztncui.ztncui /opt/key-networks/ztncui/.env命令，将文件所有权交给 ztncui 用户和组。
执行systemctl enable ztncui和systemctl restart ztncui命令，设置开机自启动并重启 ZTNCUI 服务，使新配置生效。
通过https://公网IP:3443地址访问 ztncui 服务，可自行配置 SSL 证书。使用默认账号密码登录，即admin/password，然后重新设置密码。

点击Add network创建一个网络，再回到Networks，点击Easy setup进行虚拟网段分配，随后的使用便与官方的节点网络控制器相同了。

ztncui 面板的安全访问方式

最简单的方式是为面板访问添加 SSL 证书。而还有一种方法，能将面板完全与外网隔离，简单来说是将面板完全局限在自己创建的虚拟局域网里，具体方法如下：

首先zerotier-cli join 网络ID加入 ztncui 创建的网络中，此时后台会为该设备分配虚拟网络 IP，我们就可以通过该 IP 和端口号访问面板。
然后将自己的可信任设备也加入这个网络，并授权。
随后在云服务器厂商处关闭 ztncui 服务的端口号 3000 和 3443，此后在外网中，便无论如何也无法访问该面板。只有 ztncui 网络中的可信任设备可以通过服务器被分配的虚拟 IP 和端口号来访问面板。

zerotier 常用指令

查看节点 ID：zerotier-cli info
加入网络：zerotier-cli join 网络ID
离开网络: zerotier-cli leave 网络ID
网络状态: zerotier-cli listnetworks
查看节点状态: zerotier-cli listpeers
连接 moon: zerotier-cli orbit Moon节点ID Moon节点ID
退出 moon: zerotier-cli deorbit Moon节点ID
Windows 重启 zerotier：net stop zerotier-one && net start zerotier-one
显示 moon 信息：zerotier-cli listmoons

如何投屏和串流？

Thu, 25 Jul 2024 00:00:00 GMT

串流

影音串流技术是一种线上即时影音播放技术，有别于传统的 MPEG 或 MP3 等影音播放方式，应用串流(streaming)技术传送多媒体的特点，在于可以边看边下载，大幅节省使用者等待的时间。
- 方案：
- Sunshine+Moonlight
注：默认内网条件下使用，没有内网条件的可以通过内网穿透，创造条件，比如 zerotier 的 P2P 连接，Sakura 的 frp 反向代理如果有 IPv4 或 IPv6 ，那就直接在外网条件下使用

Sunshine+Moonlight

Sunshine 可以简单理解为 PC 的信息流发射端，也就是将视频和音频信息打包，准备发送。下载地址：https://github.com/LizardByte/Sunshine/releases

下载后在右下角托盘处，选择 open sunshine 打开 web 端，注册一个账户，随后登录。
在 configuration 的 General 里改为简体中文，save->apply

在配置里的 Network 里，将 UPnP 开启，开启 IPv4+IPv6 ，记得保存应用。

最后保证 sunshine 在 Windows 的防火墙 保护范围外，或者 关闭防火墙

Moonlight 即串流的接收端，负责接收数据流，并将操作信息再回馈给主机。下载地址：
- 安卓：https://github.com/moonlight-stream/moonlight-android/releases
- PC：https://github.com/moonlight-stream/moonlight-qt/releases

在 assert 下找到对应版本的安装包后下载，随后只需要保证在同一个 内网环境 下，同时 sunshine 处于运行状态，moonlight 可自动检测，检测不到可以 手动输入 ip 连接。( ip 查询 详见 zerotier 篇：https://rolinshmily.github.io/post/Minecraft-xia-zai-%26Zerotier-ju-yu-wang-lian-ji.html)

在 moonlight 端发送连接请求后，会要求 sunshine 端输入对应 pin 码

投屏

一般应用于 PC 操作安卓手机 或者 直播安卓手机游戏 时
scrcpy 程序 下载地址：https://github.com/Genymobile/scrcpy/releases

在第一次进行投屏时，请使用数据线连接手机与 pc，并打开手机的 usb 调试 功能
- USB 调试 一般在 开发者选项 中，需要在设置里找到 关于手机 -> 版本信息 -> 多次点击 软件版本 （出现提示 处于开发者模式）-> 回退到 系统与升级 -> 开发者选项

运行程序文件，等待手机界面出现，如果不行，可以将手机的 usb 模式选择为 管理文件

WiFi 连接配置：

保持有线连接状态，在程序根目录下运行 cmd
输入指令：.\scrcpy.exe -d 运行后关闭手机界面
输入指令：.\scrcpy.exe --tcpip 此后，保证手机处于 PC 的 wifi 连接下，可拔掉数据线。

在此 cmd 下输入.\scrcpy.exe -h即可查看所有指令 连接方式：

如果使用 有线连接，则直接运行程序文件 scrcpy.exe 即可
如果使用 wifi 连接，则可以在根目录下新建一个 start.bat 文件（可以先创建 start.txt 再将后缀名改为 bat），编辑，写入代码.\scrcpy.exe -e保存，双击运行 start.bat 即可

机器学习

Wed, 24 Jul 2024 00:00:00 GMT

第一章--内容框架与基本概念

1. 机器学习的范围

机器学习 属于 AI人工智能 的分支技术
深度学习 又是 机器学习 的技术之一

2. 机器学习的目的与方法

机器学习 的目的在于发现大量数据中的一个模型 (也就是函数)
如果将 机器学习中的模型 类比成函数, 那么 特征 feature 也就是 自变量 x, 标签 lable 也就是 因变量 y
机器学习 是在已知 数据集 的基础上, 通过训练得到了特征与标签之间的一个函数.
将经过了训练的数据称为 训练数据集 , 而另一组待推测的数据称为 测试数据集

3. 机器学习的类别

根据数据是否有标签来分类, 常见分为 监督学习, 无监督学习, 半监督学习

监督学习 : 数据集都有标签
无监督学习 : 数据集都没有标签
半监督学习 : 数据集中只有少量有标签

4. 深度学习基本概念

属于 机器学习 的分支, 因此最重要的区分点也就是模型, 深度学习 使用的模型是 神经网络
把层数较多、结构比较复杂的神经网络的机器学习技术叫做 深度学习

5. 机器学习的两大基本问题

回归问题 : 通常用来预测一个值, 其标签值是连续的.
分类问题 : 将事物标记为一个类别标签, 结果为离散值

6. 基本机器学习术语

术语	定义	数学描述
数据集	数据的集合	${(x_1,y_1),\cdots,(x_n,y_n)}$
样本	数据集中的一条具体记录	$(x_1,y_1)$
特征	用于描述数据的输入变量	${x_1,x_2,\cdots,x_n}$也是一个向量
标签	要预测的真实事物或结果, 也成为目标	$y$
有标签样本	有特征、标签，用于训练模型	$(x,y)$
无标签样本	有特征，无标签	$(x,?)$
模型	将样本的特征映射到预测标签	$f(x)$,其实也就是函数
模型中的参数	模型中的参数确定了机器学习的具体模型	$f(x)$这个函数的参数
模型的映射结果	通过模型映射出无标签样本的标签	$y'$
机器学习	通过学习样本数据，发现规律，得到模型的参数，从而得到能预测目标的模型	确定$f(x)$和其参数的过程

特征

特征是有维度的，特征的维度是指特征的数目，而非样本数目，也即 $(x_1,x_2,x_3)$ 称作一个样本，而它属于 三维特征数据集

同时，避免混淆，将向量、数组、矩阵中的维度统称为阶，例如 1D向量、2D矩阵

标签

有的数据样本有标签，而有的则没有，靠机器推断出来的标签，称作 预测标签$y'$，比较$y$和$y'$的差异，也就是在评判机器学习模型的效果

模型

机器学习中，在处理问题时，先确定模型的类型，也就是算法，再确定模型的参数，进而确定最终的模型。

7. 机器学习和深度学习框架

8个常用库，3大类: Pandas 和 Numpy 提供数据结构，支持数学运算；Matplotlib 和 Seaborn 用于数据可视化；剩余4个库提供算法，其中 Scikit-learn 是机器学习框架，TesnsorFlow、Keras 和 Pytorch 则是深度学习框架。

Pandas 预置数据结构：

Series ：1D数组，与 Numpy 中的一维数组 (array) 类似。这两者与 Python 基本数据结构列表 (list) 也很相似。
TimeSeries ：以时间为索引的Series
DataFrame ：2D的表格型数据结构，Series的容器
Panel ：3D的数组，DataFrame 的容器

Numpy ：Python的数学拓展包，提供强大的多维数组对象array，提供大量API支持数组运算。
Matplotlib ：Python与Numpy的可视化操作界面，通过API像应用程序提供嵌入式绘图功能。
Seaborn ：再Matplotlib基础上设计出的绘图库
Scikit-learn ：包含大量可以直接使用的机器学习算法。
TensorFlow ：编程建立在“图”的概念之上，比较难快速上手。
Keras ：建立在TensorFlow等后端框架之上，也就是Keras更“高级”，也即“简单”，本质上还是调用了TensorFlow。
Pytorch ：是TensorFlow的竞争对手，相对来说上手更简单。

8. 机器学习项目实战架构

大致分为5个环节：（1）问题定义（2）数据的收集和预处理（3）模型算法的选择（4）选择机器学习模型（5）超参数调式和性能优化

Python与Pytorch的环境搭建

Thu, 18 Jul 2024 00:00:00 GMT

！！⚠️Attention⚠️！！

文章已重写至【重置版】在Windows系统中安装深度学习框架Pytorch与TensorFlow

使用VScode搭建Python与Pytorch环境

1.Anaconda

Anaconda 是一个开源的Python发行版本，其包含了conda、Python等180多个科学包及其依赖项。(详见百科)
总之，当你安装了Anaconda，就不用去Python官网下载解释器了，因为Anaconda内置有Python解释器。
当然了，为确保Anaconda完美安装，请务必将电脑中的Python卸载干净。
Anaconda官网下载地址：https://www.anaconda.com/download/success

安装完成后再配置一下 帐户环境变量

2.Cuda (需要Nvidia显卡)

CUDA（Compute Unified Device Architecture），是显卡厂商NVIDIA推出的运算平台。 CUDA是一种由NVIDIA推出的通用并行计算架构，该架构使GPU能够解决复杂的计算问题。它包含了CUDA指令集架构（ISA）以及GPU内部的并行计算引擎。(详见百科)
下载地址：https://developer.nvidia.com/cuda-toolkit-archive

之后双击打开，一路点击下一步等待安装完成即可。

3.cuDNN

NVIDIA cuDNN是用于深度神经网络的GPU加速库。它强调性能、易用性和低内存开销。NVIDIA cuDNN可以集成到更高级别的机器学习框架中，如谷歌的Tensorflow、加州大学伯克利分校的流行caffe软件。简单的插入式设计可以让开发人员专注于设计和实现神经网络模型，而不是简单调整性能，同时还可以在GPU上实现高性能现代并行计算。
下载地址：https://developer.nvidia.com/cudnn-downloads

4.Pytorch

PyTorch 是一个开源的Python机器学习库，基于Torch库，底层由C++实现，应用于人工智能领域，如计算机视觉和自然语言处理。(详见百科)
下载地址：https://pytorch.org/get-started/locally/

Cuda 根据安装版本来选择，可以向下兼容。
复制给出的下载指令，例如这里给出的是：
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
接下来在Windows搜索栏搜索 Anaconda Prompt 打开后将给出的下载指令输入进去。(此时的Pytorch就安装在了整个系统大环境下)

5.VScode相关设置

1. 安装python拓展：

打开VScode拓展，搜索python，安装

2. 设置python环境：

打开VScode设置，(左下角齿轮->选择设置settings)

3. 设置python解释器：

任意打开一个python文件，例如test.py
其中编写代码 print(123)

至此大功告成

C&C++在VScode中的配置

Sun, 14 Jul 2024 00:00:00 GMT

前言

针对准备学习编程的新人，一般是从 c 语言开始，当然 c++是可以兼容 c 语言的，且环境配置上差不太多，在这里一起讲。
编程所用必备的工具一般是 IDE（集成开发环境），其中包含了代码 编辑器、编译器、调试器 和图形化操作界面，方便使用。
而因为 VScode 它本质上是一个 编辑器，而非 IDE，也即只能写代码而不能直接编译运行，所以我们要配置环境，使得它能够完成代码生产的完整工具链。
因此我们在这里需要安装 编辑器，编译器，写配置文件 搭建环境。

编辑器 -- Visual Studio Code > 编译器 -- GCC(GNU Compiler Collection)

手把手从 0 开始构建 IDE 环境

下面将分步骤，详细说明每一步在干什么，以及需要做什么，从而搭建起我们编写代码的环境。

1.宇宙最强编辑器--Visual Studio Code

下载地址： https://code.visualstudio.com/

全部勾选即可
打开后在左侧，选择拓展

搜索 chinese 和 c 安装这两个拓展，C/C++ 拓展是个包，只需安装一个，另外几个都会自动安装。

2.Windows 系统下的 GCC 编译器--MinGW-w64

最初的原版 gcc 编译器并不能在现如今更流行的 windows 系统 下使用，因此我们用的是 MinGW(全称 Minimalist GNU on Windows) 其下有两个版本 MinGW 和 MinGW-w64，前者只能编译生成 32 位程序，而后者能够编译生成 32 位或 64 位程序，因此我们选择后者。

MinGW-w64 下载地址： https://sourceforge.net/projects/mingw-w64/files/
进去之后向下滑动找到如下版本：

下载完成后会得到一个压缩包，在任意盘符下创建文件夹，名为 MinGW，将压缩文件拖进该文件夹中解压，我这里在 D 盘 中演示

打开 bin 文件夹后，里面的 gcc.exe是 C 语言的编译器，g++.exe 是 C++语言 的编译器，gdb.exe 是用来调试程序的 debug 工具

3.配置帐户环境变量

打开 windows 搜索栏，输入 环境变量

此后我们打开 cmd 命令行

此时需要重新启动电脑

4.文件结构

学习阶段 大多数文件都是独立运行，或者是非拓展性文件间的互相访问，这是一种使用环境。
而在 项目工作 中的文件夹中，有许多为了方便管理的拓展性文件，这又是一种使用环境。
这两种环境我们要单独为其编写配置文件，分成 单文件结构 和 多文件结构
我们可以在一个名为 project 的文件夹中创建名为 CODE_C 的文件夹来管理 c 语言文件，再在 **CODE_C**文件夹下创建 C_Single 和 C_Multiple 来区分单文件与多文件结构。
此时在 C_Single 文件夹下就可以创建用于测试的项目文件夹，比如名为 test_v 的文件夹，在此文件夹下创建 test.c 文件来编写代码，当我们去编译执行代码时，将会产生一个 exe 可执行程序文件，我们可以在项目文件夹 test_v 下创建 bin 文件夹来存放生成的程序文件。
example：

在多文件结构中，只需要在单文件结构中存放代码文件的位置，替换成存放文件夹就好，源代码和 exe 文件均在这个文件夹中。

5.基于文件结构的 VScode 配置文件

简单来说，我们需要创建两个文件 tasks.json 文件和 launch.json 文件来分别实现 build 构建功能和 debug 调试功能
创建文件的位置要求是，在存放源文件的文件夹的根目录，以 c 语言单文件为例，也就是在 C_Single文件夹下创建。
注意请大致看一看 json 文件的内容，要注意修改 某些路径，配置默认编译器是调用 gcc 也即 c 语言编译器，若用 c++语言请在 json 文件中修改对应参数。

单文件结构 tasks.json

{
  "version": "2.0.0",
  "tasks": [
    {
      //这个大括号里是‘构建（build）’任务
      "label": "build", //任务名称，可以更改，不过不建议改
      "type": "shell", //任务类型，process是vsc把预定义变量和转义解析后直接全部传给command；shell相当于先打开shell再输入命令，所以args还会经过shell再解析一遍
      "command": "gcc", //编译命令，这里是gcc，编译c++的话换成g++
      "args": [
        //方括号里是传给gcc命令的一系列参数，用于实现一些功能
        "${file}", //指定要编译的是当前文件
        "-o", //指定输出文件的路径和名称
        "${fileDirname}\\bin\\${fileBasenameNoExtension}.exe", //承接上一步的-o，让可执行文件输出到源码文件所在的文件夹下的bin文件夹内，并且让它的名字和源码文件相同
        "-g", //生成和调试有关的信息
        "-Wall", // 开启额外警告
        "-static-libgcc", // 静态链接libgcc
        "-fexec-charset=GBK", // 生成的程序使用GBK编码，不加这一条会导致Win下输出中文乱码
        "-std=c11" // 语言标准，可根据自己的需要进行修改，写c++要换成c++的语言标准，比如c++11
      ],
      "group": {
        //group表示‘组’，我们可以有很多的task，然后把他们放在一个‘组’里
        "kind": "build", //表示这一组任务类型是构建
        "isDefault": true //表示这个任务是当前这组任务中的默认任务
      },
      "presentation": {
        //执行这个任务时的一些其他设定
        "echo": true, //表示在执行任务时在终端要有输出
        "reveal": "always", //执行任务时是否跳转到终端面板，可以为always，silent，never
        "focus": false, //设为true后可以使执行task时焦点聚集在终端，但对编译来说，设为true没有意义，因为运行的时候才涉及到输入
        "panel": "new" //每次执行这个task时都新建一个终端面板，也可以设置为shared，共用一个面板，不过那样会出现‘任务将被终端重用’的提示，比较烦人
      },
      "problemMatcher": "$gcc" //捕捉编译时编译器在终端里显示的报错信息，将其显示在vscode的‘问题’面板里
    },
    {
      //这个大括号里是‘运行(run)’任务，一些设置与上面的构建任务性质相同
      "label": "run",
      "type": "shell",
      "dependsOn": "build", //任务依赖，因为要运行必须先构建，所以执行这个任务前必须先执行build任务，
      "command": "${fileDirname}\\bin\\${fileBasenameNoExtension}.exe", //执行exe文件，只需要指定这个exe文件在哪里就好
      "group": {
        "kind": "test", //这一组是‘测试’组，将run任务放在test组里方便我们用快捷键执行
        "isDefault": true
      },
      "presentation": {
        "echo": true,
        "reveal": "always",
        "focus": true, //这个就设置为true了，运行任务后将焦点聚集到终端，方便进行输入
        "panel": "new"
      }
    }
  ]
}

launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      //这个大括号里是我们的‘调试(Debug)’配置
      "name": "Debug", // 配置名称
      "type": "cppdbg", // 配置类型，cppdbg对应cpptools提供的调试功能；可以认为此处只能是cppdbg
      "request": "launch", // 请求配置类型，可以为launch（启动）或attach（附加）
      "program": "${fileDirname}\\bin\\${fileBasenameNoExtension}.exe", // 将要进行调试的程序的路径
      "args": [], // 程序调试时传递给程序的命令行参数，这里设为空即可
      "stopAtEntry": false, // 设为true时程序将暂停在程序入口处，相当于在main上打断点
      "cwd": "${fileDirname}", // 调试程序时的工作目录，此处为源码文件所在目录
      "environment": [], // 环境变量，这里设为空即可
      "externalConsole": false, // 为true时使用单独的cmd窗口，跳出小黑框；设为false则是用vscode的内置终端，建议用内置终端
      "internalConsoleOptions": "neverOpen", // 如果不设为neverOpen，调试时会跳到“调试控制台”选项卡，新手调试用不到
      "MIMode": "gdb", // 指定连接的调试器，gdb是minGW中的调试程序
      "miDebuggerPath": "D:\\MinGW\\mingw64\\bin\\gdb.exe", // 指定调试器所在路径，如果你的minGW装在别的地方，则要改成你自己的路径，注意间隔是\\
      "preLaunchTask": "build" // 调试开始前执行的任务，我们在调试前要编译构建。与tasks.json的label相对应，名字要一样
    }
  ]
}

多文件结构 tasks.json

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build",
      "type": "shell",
      "command": "gcc", //写c++换成g++
      "args": [
        "${fileDirname}\\*.c", //写c++把 *.c 换成 *.cpp
        "-o",
        "${fileDirname}\\${fileBasenameNoExtension}.exe",
        "-g",
        "-Wall",
        "-static-libgcc",
        "-fexec-charset=GBK",
        "-std=c11" //写c++换成c++标准
      ],
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "presentation": {
        "echo": true,
        "reveal": "always",
        "focus": false,
        "panel": "new"
      },
      "problemMatcher": "$gcc"
    },
    {
      "label": "run",
      "type": "shell",
      "dependsOn": "build",
      "command": "${fileDirname}\\${fileBasenameNoExtension}.exe",
      "group": {
        "kind": "test",
        "isDefault": true
      },
      "presentation": {
        "echo": true,
        "reveal": "always",
        "focus": true,
        "panel": "new"
      }
    }
  ]
}

launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug",
      "type": "cppdbg",
      "request": "launch",
      "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${fileDirname}",
      "environment": [],
      "externalConsole": false,
      "internalConsoleOptions": "neverOpen",
      "MIMode": "gdb",
      "miDebuggerPath": "D:\\MinGW\\mingw64\\bin\\gdb.exe",
      "preLaunchTask": "build"
    }
  ]
}

至此，在 VScode 中编写一个 Hello,World! 并编译执行，也就不成问题了。

Minecraft基础 | 虚拟局域网联机

Sat, 22 Jun 2024 00:00:00 GMT

Java版Minecraft下载

一、启动器 HMCL 、 PCL2 、官方启动器

HMCL --由 huangyuhui 制作主页: https://hmcl.huangyuhui.net/ GitHub项目地址:https://github.com/HMCL-dev/HMCL

PCL2 --由 龙腾猫跃 制作爱发电文件地址: https://afdian.com/p/0164034c016c11ebafcb52540025c377 GitHub项目地址: https://github.com/Hex-Dragon/PCL2

一般通过这种途径下载，将会得到一个 .zip 压缩包文件，然后找到一个文件夹解压下来，将会得到两个程序文件：

官方启动器 --由 Mojang 制作（当然游戏也是人家做的）网址：https://www.minecraft.net/zh-hans

在这里我们能找到购买游戏的途径（Minecraft游戏其实是付费的），购买之后就能够得到 Java版 和 基岩版，如果不行的话，可以去 Microsoft Store（俗称微软商店）中购买

购买游戏其实对 Java版 影响不大，因为微软接手后大力发展的是在自家 XBox 平台上的 基岩版 minecraft，但是购买了游戏后，Java版 用户将会被分配一个唯一的 uuid，用于 Java 服务器的 正版验证 ，从而进行有效联机

uuid 查询网站：https://mcuuid.net/

二、游戏本体下载

打开非官方启动器后都是可视化操作界面，接下来提一下游戏本体的下载。

在启动器中的下载版块里，首先 选择游戏版本，接下来选择模组加载器

Forge ：具有大量老牌大型模组社区，可供下载。游戏光影一般搭配 OptiFine 使用，不过如今 Forge 优化模组中也出现了 Fabric 里类似 iris 的存在，但不安装 OptiFine 也不影响游戏本体的下载与游玩。
Fabric ：小鲜肉，起初是大多小型模组的生态圈，如今也有很多大型模组，因 Fabric 的许多优化都比 Forge 更好，而被做了一些移植。下载时要搭配 Fabric API ，这是必要的，启动器里一般默认自动勾选。

之后通过启动器的一键式安装，你就得到了游戏本体了。但是众所周知 Java版Minecraft 是需要 Java环境 来运行的，因此你需要下载 Java

三、Java下载

下面有两种方法下载 Java，一个是通过官网安装Java，另一个是通过 Oracle中国 的Java整合版，由于后者是国内的，我更推荐通过Oracle下载。

Java官网 ： https://www.java.com/zh-CN/
Oracle地址 ： https://www.oracle.com/cn/java/technologies/downloads/

下面是 Oracle 的下载界面：

一般选择 Installer，下载好之后双击都是安装程序。

安装好 Java 后，通过启动器启动游戏就可以开始游玩了。

联机

一、联机工具下载

我们使用的工具是 ZeroTier 一个专门用来建立点对点虚拟专用网(P2P VPN)

以 Windows 系统为例

下载地址：https://www.zerotier.com/

点击 Download

一般情况下直接点击 MSI Installer (x86/x64) 下载完成如图

安装前请把 杀毒软件 全部关闭，尽量不要出现被拦截的情况。
双击进行安装后，在右下角托盘处，你会看到如图图标。

二、网络创建者（房主）的操作：

回到 ZeroTier 官网：https://www.zerotier.com/
选择 Sign Up 注册一个账号，然后 Log In 登录

Create A Network，点击进一个 Network 中

复制 Network ID 给你的朋友

等待朋友发来请求，下拉找到请求，勾选

对此网络的管理均在此网页内进行

三、网络连接者：

点击托盘图标，点击 Join New Network

将代码输入，点击 Join

等待创建者同意加入网络

注意 : 请把 Windows防火墙 中的公用网络关闭，防止连接失败。

四、游戏房主：

任意界面下按 win键 + R键，输入 cmd

输入 ipconfig 找到以太网Zerotier下的描述，复制 IPv4地址

打开任意世界，对局域网开放 ，注意如果朋友是离线用户，一定要关闭 在线验证

将 端口号 和 IPv4地址 发给你的朋友

五、游戏玩家：

多人游戏，添加服务器
输入 IPv4地址 : 端口号 ,注意 “:” 一定是英文输入法下的

连接进入

SrP-BloG

SrP-CFG 游戏设置预设文件 | CS2

简介

CFG 简介

CFG 存放位置

一个特殊的 CFG 模板

如何创建一个CFG文件

视频设置文件

还原与备份

一些有趣的控制台指令

如何即时查看CFG的命令参数

设置启动项

SrP-CFG_ForCS2

在Windows上使用MSYS2+MinGW工具链 | gcc | gdb | cmake | make | Ninja | VScode

相关链接

MSYS2+VScode安装与配置

VScode常用插件(拓展)与设置

MSYS2集成终端

C/C++环境配置

Stm32环境配置

ClaudeCode安装与使用 | Agent | CC-Switch

相关链接

Windows终端

Node环境

ClaudeCode安装

CC-Switch应用

ClaudeCode基础使用

Git For Windows

Windows Defender 卸载程序 | Bluetooth Audio Receiver

相关链接

Defender Remover

Bluetooth Audio Receiver

树莓派Pico2W实现无线DualSense手柄(PS5)的满血功能 | Raspberry Pi | Play Station5

相关链接

使用简述

手柄连接

关于

使用Docker部署Umami统计服务 | Nginx | PostgreSQL

相关链接

Docker-Compose配置

PostgreSQL数据库备份与恢复

Nginx+Certbot配置

结语

Docker部署自建Bitwarden密码管理器 | Nginx

相关链接

Docker-Compose配置

Nginx+Certbot配置

结语

使用Spire.Doc将代码块插入Word文档中 | Python

相关链接

脚本说明

功能特性

依赖要求

当前支持的代码文件类型

使用方法

1. 准备代码文件

2. 运行脚本

3. 查看输出结果

脚本内容

个人脚本仓库

使用yt-dlp下载互联网上的任何音视频 | FFmpeg | Python

相关链接

yt-dlp 实用工具集

脚本说明

依赖

quick_grab.py — 快速获取视频

quick_audio.py — 快速获取音频

脚本内容

quick_grab.py

quick_audio.py

个人脚本仓库

LGnewUI-2 部署 | Docker | PHP | MySQL | Nginx | Certbot

相关链接

项目资源获取

Docker的安装配置

MySQL的compose配置

PHP-FPM的compose配置

MySQL与PHP通信

Nginx、Certbot安装与配置(网站上线)

防IP直连的Nginx配置(选用)

如何创建一个`CFG`文件

如何即时查看`CFG`的命令参数

关于 `gen_img.py`