一、前期准备：明确需求与工具清单

1. 适用场景

• 剪映字幕识别次数用完，需要免费替代工具；
• 视频只有语音，需生成带时间轴的字幕（SRT格式，可直接导入剪映）；
• 视频内有硬字幕（烧录在画面里，无法关闭），需提取为文本字幕；
• 批量处理视频字幕，追求高识别率、无网络依赖。

2. 核心工具清单（全部免费，附官方/镜像下载链接）

二、详细安装步骤（Windows 系统，全程实操无坑）

重点讲解「Python + Whisper + FFmpeg」的安装，这是本地免费提取字幕的核心组合，适用于大多数场景（语音转字幕、硬字幕识别）。

第一步：安装 Python 3.10.x（关键步骤，别踩坑！）

Python 是运行 Whisper 的基础，必须安装正确版本，且配置好环境变量，否则后续命令无法执行。

1. 下载安装包： 优先从官方下载 Python 3.10.11（稳定版），打开链接 Python 3.10.11 官方下载页，拉到页面底部「Files」区域，点击「Windows x86-64 executable installer」（64位系统，目前绝大多数电脑都是64位）； 如果官网下载速度慢，直接用国内镜像：Python 3.10.10 华为镜像，下载后得到「python-3.10.10-amd64.exe」文件（存到桌面，方便后续查找）。
2. 开始安装： 双击打开下载好的 .exe 安装文件，弹出安装窗口，第一步必须勾选左下角的「Add Python 3.10 to PATH」（这一步是让系统识别 Python 和 pip 命令，不勾选会导致后续报错）； 勾选完成后，点击窗口中间的「Customize installation」（自定义安装），避免默认路径的权限问题； 下一个页面，所有选项保持默认（全部勾选），点击「Next」； 再下一个页面，点击「Browse」，将安装路径改为「D:\Python310」（放在 D 盘根目录，后续找文件更方便，也能避免 C 盘权限问题），点击「Install」； 等待进度条走完，出现「Setup was successful」，说明安装成功，点击「Close」关闭窗口。
3. 验证安装是否成功： 按下键盘「Win + R」，输入「cmd」，回车打开「命令提示符」（黑窗口）； 在窗口中输入以下命令，按回车： python --version 如果显示「Python 3.10.10」或「Python 3.10.11」，说明 Python 安装成功； 再输入以下命令，按回车： pip --version 如果显示「pip 2x.x.x from …」（版本号不固定），说明 pip 包管理器也正常工作。

第二步：安装 OpenAI Whisper（核心字幕提取工具）

Whisper 是 OpenAI 开源的语音转文字工具，支持多语言，识别率高，完全免费，无次数限制，安装后通过命令行即可使用。

1. 打开之前的「命令提示符」窗口（无需重新打开，继续使用即可）；
2. 输入以下命令，按回车（用国内清华源，下载速度更快，避免超时失败）： pip install openai-whisper -i https://pypi.tuna.tsinghua.edu.cn/simple
3. 等待安装完成： 安装过程中会自动下载 Whisper 所需的依赖包（如 numpy、torch 等），可能需要3-5分钟（取决于网络速度），耐心等待即可； 如果出现「Successfully installed openai-whisper-xxxx」，说明 Whisper 安装成功（参考下图安装成功示例）。

安装成功示例（截取实操过程中的成功日志）：

536.2/536.2 kB 32.9 MB/s eta 0:00:00
Collecting MarkupSafe>=2.0
  Downloading https://pypi.tuna.tsinghua.edu.cn/packages/d6/25/55dc3ab959917602c96985cb1253efaa4ff42f71194bddeb61eb7278b8be/markupsafe-3.0.3-cp310-cp310-win_amd64.whl (15 kB)
Building wheels for collected packages: openai-whisper
  Building wheel for openai-whisper (pyproject.toml) ... done
  Created wheel for openai-whisper: filename=openai_whisper-20250625-py3-none-any.whl size=804012 sha256=b79cb7341847a20d4fabe9c7598d97d96ac3889885999c89b19c590fd2b9f4ff
  Stored in directory: c:\users\dell16a\appdata\local\pip\cache\wheels\d0\a3\00\22bcce5ea9156d33bdc12123c66d55e3424c4e85aca4aa2484
Successfully built openai-whisper
Installing collected packages: mpmath, urllib3, typing-extensions, sympy, regex, numpy, networkx, more-itertools, MarkupSafe, llvmlite, idna, fsspec, filelock, colorama, charset_normalizer, certifi, tqdm, requests, numba, jinja2, torch, tiktoken, openai-whisper
Successfully installed MarkupSafe-3.0.3 certifi-2026.4.22 charset_normalizer-3.4.7 colorama-0.4.6 filelock-3.29.0 fsspec-2026.4.0 idna-3.13 jinja2-3.1.6 llvmlite-0.47.0 more-itertools-11.0.2 mpmath-1.3.0 networkx-3.4.2 numba-0.65.1 numpy-2.2.6 openai-whisper-20250625 regex-2026.4.4 requests-2.33.1 sympy-1.14.0 tiktoken-0.12.0 torch-2.11.0 tqdm-4.67.3 typing-extensions-4.15.0 urllib3-2.6.3
​
[notice] A new release of pip available: 22.3.1 -> 26.1.1
[notice] To update, run: python.exe -m pip install --upgrade pip

备注：最后出现的「pip 升级提示」可升可不升，不影响 Whisper 使用；如果想升级，输入以下命令即可：

python.exe -m pip install --upgrade pip

第三步：安装 FFmpeg（必装！否则 Whisper 无法读取视频）

FFmpeg 是一款音视频处理工具，Whisper 依赖它来读取视频/音频文件，不安装会出现「系统找不到指定的文件」报错（下文会详细讲这个报错的解决）。提供两种安装方式，任选一种即可，新手推荐第一种。

方式一：通过 Python 命令快速安装（新手首选）

1. 打开「命令提示符」窗口，输入以下命令，按回车： pip install ffmpeg-python -i https://pypi.tuna.tsinghua.edu.cn/simple
2. 安装完成后，再输入以下命令（补充系统级 FFmpeg，避免遗漏）： winget install ffmpeg
3. 等待安装完成，无需额外配置，即可正常使用。

方式二：官网下载安装（备用方案，适用于方式一报错）

1. 打开 FFmpeg 官方下载页：https://ffmpeg.org/download.html；
2. 找到「Windows builds」区域，点击对应的链接，下载最新版本的静态压缩包（如「ffmpeg-release-full.7z」）；
3. 解压压缩包，将解压后的「ffmpeg.exe」文件，复制到「D:\Python310\Scripts」文件夹中（和 Python 安装路径对应）；
4. 验证安装：在「命令提示符」中输入「ffmpeg -version」，按回车，能显示版本信息即安装成功。

三、Whisper 实操：一键提取视频字幕（核心步骤）

安装完成后，即可用 Whisper 提取视频字幕，支持语音转文字（无字幕视频）、硬字幕识别（画面烧录字幕），生成的 SRT 文件可直接导入剪映、PR 等剪辑工具。

实操步骤（以 Windows 系统为例）

1. 准备视频文件：将需要提取字幕的视频（如「housing分析设置.mp4」）放到容易找到的文件夹（推荐放到桌面，或某个路径无中文、无特殊符号的文件夹，避免报错）；
2. 打开「命令提示符」，切换到视频所在文件夹： 如果视频在桌面，输入以下命令，按回车： cd Desktop 如果视频在其他文件夹如F盘，输入以下命令（替换为自己的视频路径），按回车： cd /d F:~video_made\haoyong8.top\housing力学分析
3. 执行字幕提取命令： 复制以下命令，粘贴到「命令提示符」中，按回车（替换「housing分析设置.mp4」为自己的视频文件名）：

命令参数说明（新手必看）

• 「housing分析设置.mp4」：替换为你的视频文件名（如果文件名有中文，建议加英文双引号 “”，避免识别失败）；
• –model small：使用「small」模型，兼顾识别速度和准确率，适合普通电脑；如果电脑配置较高，可替换为「medium」或「large」（识别率更高，但速度更慢）；
• –output_format srt：指定输出格式为 SRT（剪映、PR 等工具均支持，可直接导入）；
• –language zh：指定识别语言为中文，加快识别速度，提高识别准确率（如果是英文视频，可改为「–language en」）。

whisper "housing_force1.mp4" --model small --output_format srt --language zh

实操效果

\1. 第一次执行命令时，会自动下载「small」模型（约461M），下载速度取决于网络，耐心等待即可（下载完成后，后续使用无需重复下载）； 2. 模型下载完成后，Whisper 会自动识别视频中的语音/硬字幕，识别过程中会显示进度； 3. 识别完成后，视频所在文件夹会自动生成一个「housing分析设置.srt」文件（和视频文件名一致）； 4. 双击打开 SRT 文件，可查看字幕内容和时间轴，直接导入剪映即可使用（剪映中导入字幕，选择「导入字幕文件」，找到 SRT 文件即可）。

四、常见报错及解决方案（实操避坑重点）

新手安装和使用过程中，可能会遇到一些报错，以下是实操中最常见的2个报错，附上详细解决方法（对应之前实操中遇到的问题）。

报错1：FileNotFoundError: [WinError 2] 系统找不到指定的文件

【报错场景】执行 Whisper 提取命令时，出现以下报错：

F:\~video_made\haoyong8.top\housing力学分析>whisper housing分析设置.mp4 --model small --output_format srt
100%|███████████████████████████████████████| 461M/461M [00:23<00:00, 20.2MiB/s]
D:\Python310\lib\site-packages\whisper\transcribe.py:132: UserWarning: FP16 is not supported on CPU; using FP32 instead
  warnings.warn("FP16 is not supported on CPU; using FP32 instead")
Traceback (most recent call last):
  File "D:\Python310\lib\site-packages\whisper\transcribe.py", line 615, in cli
    result = transcribe(model, audio_path, temperature=temperature, **args)
  File "D:\Python310\lib\site-packages\whisper\transcribe.py", line 139, in transcribe
    mel = log_mel_spectrogram(audio, model.dims.n_mels, padding=N_SAMPLES)
  File "D:\Python310\lib\site-packages\whisper\audio.py", line 140, in log_mel_spectrogram
    audio = load_audio(audio)
  File "D:\Python310\lib\site-packages\whisper\audio.py", line 58, in load_audio
    out = run(cmd, capture_output=True, check=True).stdout
  File "D:\Python310\lib\subprocess.py", line 503, in run
    with Popen(*popenargs, **kwargs) as process:
  File "D:\Python310\lib\subprocess.py", line 971, in __init__
    self._execute_child(args, executable, preexec_fn, close_fds,
  File "D:\Python310\lib\subprocess.py", line 1440, in _execute_child
    hp, ht, pid, tid = _winapi.CreateProcess(executable, args,
FileNotFoundError: [WinError 2] 系统找不到指定的文件。
Skipping housing分析设置.mp4 due to FileNotFoundError: [WinError 2] 系统找不到指定的文件。

【报错原因】缺少 FFmpeg 工具，Whisper 无法读取视频文件；或视频路径/文件名有中文、特殊符号，导致识别失败。

【解决方案】

1. 优先安装 FFmpeg：按照本文「第二步：安装 FFmpeg」的步骤，重新安装 FFmpeg（推荐方式一，命令安装更快捷）；
2. 检查视频路径和文件名：确保视频路径无中文、无特殊符号（如「~」「@」「#」等），如果有，修改为英文路径和文件名；
3. 重新执行提取命令：如果文件名有中文，给文件名加上英文双引号，如： whisper “housing分析设置.mp4” –model small –output_format srt –language zh

报错2：python –version 提示“不是内部或外部命令”

【报错场景】安装 Python 后，在「命令提示符」中输入「python –version」，提示“不是内部或外部命令，也不是可运行的程序或批处理文件”。

【报错原因】安装 Python 时，未勾选「Add Python 3.10 to PATH」，导致系统无法识别 Python 命令。

【解决方案】

1. 卸载当前 Python：打开「控制面板」→「程序和功能」，找到「Python 3.10.x」，右键卸载；
2. 重新安装 Python：按照本文「第一步：安装 Python 3.10.x」的步骤，重新安装，务必勾选「Add Python 3.10 to PATH」；
3. 重新验证：打开新的「命令提示符」，输入「python –version」，显示版本信息即解决。

报错3：pip install 下载慢/报错

【报错场景】执行「pip install openai-whisper」时，下载速度极慢，或出现「Read timed out」超时报错。

【报错原因】默认使用国外的 Python 源，网络不稳定。

【解决方案】使用国内清华源，命令修改为：

pip install openai-whisper -i https://pypi.tuna.tsinghua.edu.cn/simple

五、补充方案：其他免费字幕提取工具（备用）

如果不想安装 Python 和 Whisper，可选择以下备用方案，同样免费、无次数限制，适合偶尔使用的场景。

方案1：Video-Subtitle-Extractor（专门提取硬字幕）

适合视频内有硬字幕（烧录在画面里）的场景，无需安装 Python，下载免安装版即可使用。

1. 下载工具： GitHub 地址：Video-Subtitle-Extractor 国内镜像（下载更快）：VSE 码云地址，找到「Windows CPU 版本」，下载压缩包；
2. 操作步骤： 解压下载的压缩包，双击打开「video_subtitle_extractor.exe」； 点击「导入视频」，选择需要提取字幕的视频； 框选视频中字幕出现的区域（避免识别到其他无关文字）； 点击「开始提取」，软件会自动 OCR 识别硬字幕，生成 SRT 文件； 识别完成后，可手动修改错别字，点击「导出字幕」，保存为 SRT 文件即可。

方案2：提词匠小程序（在线免费，无需装软件）

适合手机端、偶尔提取字幕的场景，微信内直接使用，无需下载任何软件，支持导出 SRT 文件。

1. 打开方式：微信搜索「提词匠」小程序，认准正版（避免山寨小程序）；
2. 操作步骤： 打开小程序后，选择「视频转文字」； 从手机相册或聊天记录中，选择需要提取字幕的视频； 等待识别完成（1分钟视频约5秒出结果）； 识别完成后，可复制字幕文本，或点击「导出 SRT」，将字幕文件保存到手机，再导入电脑剪映即可。

备注：提词匠支持本地视频上传、音频上传，还支持粘贴国内主流平台（抖音、快手、视频号等）的公开视频链接提取字幕，处理后的文件服务器会立即删除，保护隐私。

六、总结

本文分享的方案，完美解决剪映字幕识别限免不够用的问题，核心推荐「Python + OpenAI Whisper」组合，优势如下：

• 完全免费，无次数限制，无水印，本地运行，不依赖网络；
• 识别率高，支持中文/英文等多语言，兼顾语音转文字、硬字幕识别；
• 生成的 SRT 文件可直接导入剪映、PR 等剪辑工具，无缝衔接剪辑流程；
• 批量处理方便，适合需要频繁提取字幕的小伙伴。

整个流程从软件下载、安装，到实操命令、报错解决，都做了详细讲解，新手按照步骤操作，就能轻松搞定字幕提取。如果在操作过程中遇到其他报错，可直接复制报错提示，到我的博客留言交流，会第一时间帮忙排查解决！

经过数次验证，确认手动可以锁定配置文件（最彻底）

这是最可靠的解决路径，可以直接“写死”你的单位偏好。

1. 关闭Ansys软件：确保Workbench和Mechanical都已完全退出。
2. 定位配置文件夹：在Windows资源管理器地址栏输入 %appdata%\Ansys 并回车。
   • 你会看到一个以版本号命名的文件夹，例如 v251 代表2025 R1版本。进入对应你当前使用版本的文件夹。
3. 找到配置文件：在该文件夹内，找到并进入 UserRegFiles_XXXX 目录（XXXX是随机数字）。里面有一个名为 software.xml 的文件，这个文件负责保存你在Mechanical中的各种偏好设置

1. 编辑文件：用记事本打开 software.xml，搜索 currentunitsys。你会看到类似 <setting name="currentunitsys" value="..."> 的字段。
2. 修改并锁定：将 value 修改为你需要的单位制代码1。关键步骤：保存文件后，右键点击 software.xml，选择“属性”，勾选“只读”，然后确定。这会强制Ansys只能读取你的设置，而无法将其重置

注意：设置只读后，你在Mechanical中任何其他试图更改并保存设置的尝试也会失效。如果需要临时调整，记得先取消只读。

一、虚拟化 / PVE 部署工具（官方正版）

1. Proxmox VE（PVE）

• 官方下载：Proxmox VE 官方下载页 (https://www.proxmox.com/en/downloads)
• 适用场景：服务器虚拟化部署、多系统嵌套、All In One 主机搭建
• 配套教程待定：PVE 从零部署保姆级教程、PVE 网络桥接配置 、硬盘直通实操指南。

2. VMware Workstation Player（免费个人版）

• 官方下载：VMware 个人免费版官网 (https://www.vmware.com/products/workstation-player.html)
• 适用场景：个人本地虚拟机测试、系统镜像调试
• 配套教程：VMware 虚拟机安装与网络配置, 镜像导入实操

3. Ubuntu（开源 Linux 服务器系统）

• 官方网站：Ubuntu 官方首页 (https://ubuntu.com/)
• 官方下载：Ubuntu 桌面版 / 服务器版镜像下载 (https://ubuntu.com/download)
• 适用场景：服务器搭建、Docker 部署、开发环境、家用虚拟机、长期稳定运维
• 配套教程：Ubuntu 24.04 零基础安装配置 、Ubuntu 常用命令大全 、Ubuntu 开机自启设置

4. VirtualBox（开源免费）

• 官方下载：VirtualBox 官方下载 (https://www.virtualbox.org/wiki/Downloads)
• 适用场景：轻量级本地虚拟化、小众系统测试
• 配套教程：VirtualBox 无坑安装、虚拟机互通配置

二、NAS / 软路由运维工具（官方开源 / 正版）

1. 群晖 DSM（官方原版）

• 官方下载：iStoreOS 官方固件库 (https://www.istoreos.com/)
• 适用场景：软路由系统部署、内网穿透、网络管理
• 配套教程：iStoreOS 安装配置、DDNS 动态域名 、IPv6 穿透设置

2. 飞牛 OS（fnOS，国产 NAS 系统）

• 官方网站：飞牛私有云 fnOS 官方主页 (https://www.fnnas.com/)
• 官方下载：飞牛 OS 系统镜像下载页 (https://www.fnnas.com/download)
• 适用场景：家庭 NAS 部署、私有云存储、影视媒体管理、Docker 应用容器化、轻量级服务器搭建
• 配套教程：飞牛 OS 虚拟机安装体验、硬盘直通与存储池配置 (https://xrange.haoyong8.top/pve-fnos1/)、外网访问设置

3. iStoreOS

• 官方下载：群晖 DSM 官方镜像 (https://www.synology.cn/zh-cn/support/download)
• 适用场景：NAS 系统安装、硬盘挂载、网盘部署
• 配套教程：群晖 DSM 原版安装 、Docker 容器配置 、外网访问设置

4. OpenWRT

• 官方下载：OpenWRT 官方固件 (https://openwrt.org/downloads)
• 适用场景：自定义软路由、高级网络调试
• 配套教程：OpenWRT 固件刷入、防火墙规则配置

5. Portainer（开源免费）

• 官方下载：Portainer 官方部署指南 (https://www.portainer.io/download)
• 适用场景：Docker 容器可视化管理
• 配套教程：Portainer 安装与容器管理 、自启配置

6. 爱快 (iKuai) 软路由系统

• 官方网站：爱快 iKuai 官方主页 (https://www.ikuai8.com/)
• 官方下载：爱快路由系统固件下载页 (https://www.ikuai8.com/component/download)
• 适用场景：软路由部署、企业级网络管理、DPI 七层流控、多 WAN 口负载均衡、内置 AC 无线管理、网络认证服务
• 配套教程：爱快软路由安装与基础配置 、多 WAN 口链路叠加设置 、IPv6 网络配置
• 经测试iKuai在IPV6测试方面不如iStore稳定，经常因为IP前缀变化等问题失效，推荐用iStore替代iKuai系统

三、CAE 仿真实用工具（官方正版 / 教育试用）

1. Abaqus（专业有限元仿真分析）

• 官方网站：SIMULIA Abaqus 官方主页 (https://www.3ds.com/products/simulia/abaqus/)
• 教育版申请：达索系统 3DEXPERIENCE Edu 平台 (https://www.3ds.com/zh/edu/education/students/)
• 适用场景：结构力学仿真、非线性分析、多物理场耦合、工业产品性能验证
• 配套教程：Abaqus 学生版申请与安装 、材料本构模型设置 、仿真结果后处理

2. HyperMesh（专业 CAE 前处理平台）

• 官方网站：Altair HyperMesh 官方主页 (https://www.altair.com/hypermesh)
• 教育版申请：Altair 学生版软件申请 (https://www.altair.com/academic/students)
• 适用场景：CAE 仿真网格划分、几何清理修复、多求解器接口适配、复杂模型预处理
• 配套教程：HyperMesh 网格划分实操 、几何模型修复技巧 、求解器接口配置

3. CST Studio Suite（电磁仿真专业工具）

• 官方网站：CST Studio Suite 官方主页 (https://www.3ds.com/products/simulia/cst-studio-suite/)
• 学习版下载：CST Studio Suite LE 免费学习版 (https://www.3ds.com/ja/edu/education/students/solutions/cst-le)
• 适用场景：电磁场仿真、天线设计、射频电路分析、电磁兼容性 (EMC) 测试、多物理场耦合仿真
• 配套教程：CST 学习版安装与激活、天线仿真入门 、EMC 分析流程

4. Ansys Workbench Student（多物理场仿真集成平台）

• 官方网站：Ansys Workbench 产品主页 (https://www.ansys.com/zh-cn/products/ansys-workbench)
• 学生版下载：Ansys Student 官方下载页 (https://www.ansys.com/zh-cn/academic/students/ansys-student)
• 适用场景：结构力学、流体动力学、热分析、多物理场耦合仿真、工程优化设计
• 配套教程：Workbench 学生版安装配置 、仿真流程搭建 、参数化优化设计

5. Ansys HFSS（3D 高频电磁仿真软件）

• 官方网站：Ansys HFSS 产品主页 (https://www.ansys.com/zh-cn/products/electronics/ansys-hfss)
• 学生版下载：Ansys Electronics Desktop Student 官方下载 (https://www.ansys.com/zh-cn/academic/students/ansys-electronics-desktop-student)
• 适用场景：天线设计、射频 / 微波组件仿真、高速互连分析、连接器电磁性能验证、电磁兼容性 (EMC) 测试
• 配套教程：HFSS 学生版安装激活 、天线仿真基础、连接器 EMI 分析

四、通用运维开源工具（官方正版）

1. Docker（开源容器）

• 官方下载：Docker 官方下载 (https://www.docker.com/get-started/)
• 适用场景：服务容器化部署、环境隔离
• 配套教程：Docker 安装与镜像拉取、容器自启设置

2. PuTTY（开源远程连接）

• 官方下载：PuTTY 官方下载 (https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)
• 适用场景：服务器 SSH 远程连接、命令行调试
• 配套教程：SSH 连接配置 、密钥登录设置

3. FinalShell（全能远程运维工具）

• 官方官网：FinalShell 官方网站 (https://www.hostbuf.com/)
• 官方下载：FinalShell 最新版下载地址 (https://www.hostbuf.com/t/988)
• 适用场景：跨平台 SSH 远程连接、SFTP 文件管理、服务器硬件监控、内网加速
• 配套教程：FinalShell 快速上手基础配置

📌 工具使用须知

1. 本站仅提供官方正版 / 开源 / 正规教育试用工具链接，不提供破解补丁。
2. 商业用途请务必购买软件官方授权，遵守相关软件版权协议与开源协议，合规使用工具。
3. 部分试用版 / 学生版有使用权限与场景限制，安装前请仔细阅读官方许可协议。
4. 本站不对第三方官方工具的使用风险、版本兼容性承担责任，实操前请做好数据备份。

⚖️ 免责声明

1. 本页面所有工具链接均来源于软件官方公开渠道，仅用于技术交流、学习研究，无任何商业盈利目的。
2. 若部分工具链接涉及版权争议、官方下架，请通过网站留言或联系邮箱反馈，本站会第一时间核实并删除相关链接。
3. 用户自行下载、安装、使用工具所产生的一切法律责任与风险，由用户自行承担。
4. 本站配套教程仅为技术实操分享，不代表官方指导，仅供学习参考。

文档信息: 当前

• 适用人群：零基础小白、个人开发者、无企业资质创业者
• 运行环境：WordPress + GeneratePress 主题 + 宝塔面板 + BuddyPress 社区插件
• 核心目标：实现网站手机号验证码注册 / 登录，零付费、零审核、一键部署, 已在轩然阁 (haoyong8.top) 稳定上线运行
• 文档价值：全流程复盘、代码逐行解析、绝对路径指引、踩坑全记录，复制粘贴即可使用。

一、前期准备（必须完成，3 分钟搞定）

1. 阿里云服务开通（个人实名即可，无需企业资质）

1. 注册阿里云账号 → 完成个人实名认证
2. 开通【号码认证服务】（搜索产品名）→ 自动获得100 条免费短信额度
3. 创建 AccessKey ID 和 AccessKey Secret（阿里云控制台右上角头像→AccessKey 管理）

2. 宝塔面板安全配置（核心：accesskey密钥不写在代码里）

1. 打开宝塔 → 网站 → 你的网站 → 设置 → 配置文件
2. 添加环境变量（永久生效，安全不泄露）

# 阿里云短信认证密钥（宝塔配置，代码直接调用）
setenv ALIBABA_CLOUD_ACCESS_KEY_ID "你的AccessKey ID"
setenv ALIBABA_CLOUD_ACCESS_KEY_SECRET "你的AccessKey Secret"

1. 重启 nginx，完成配置

3. 基础环境确认

• 已安装 WordPress
• 已启用 GeneratePress 主题
• 已安装 BuddyPress 社区插件（注册 / 登录功能）

二、核心服务选型深度分析（为什么选这个服务？）

1. 个人开发者的唯一选择：阿里云号码认证服务，注意不是短信服务，笔者开始购买了短信服务验证无法使用，退款又重新开通的号码认证服务。

2. 最终结论

个人开发者唯一正确选择：阿里云号码认证服务（短信认证）

接口：SendSmsVerifyCode(发送) + CheckSmsVerifyCode(校验)

三、整体业务逻辑流程（小白秒懂）

用户打开注册页前端显示手机号+验证码表单用户输入手机号，点击获取验证码前端校验手机号格式调用WordPress后端接口后端请求阿里云官方接口阿里云自动生成并发送短信用户输入验证码，提交注册后端请求阿里云校验接口校验通过→注册成功；失败→提示错误

flowchart TD
    A[用户打开注册页] --> B[前端显示手机号+验证码表单]
    B --> C[用户输入手机号，点击获取验证码]
    C --> D[前端校验手机号格式]
    D --> E[调用WordPress后端接口]
    E --> F[后端请求阿里云官方接口]
    F --> G[阿里云自动生成并发送短信]
    G --> H[用户输入验证码，提交注册]
    H --> I[后端请求阿里云校验接口]
    I --> J[校验通过→注册成功；失败→提示错误]

用户打开注册页前端显示手机号+验证码表单用户输入手机号，点击获取验证码前端校验手机号格式调用WordPress后端接口后端请求阿里云官方接口阿里云自动生成并发送短信用户输入验证码，提交注册后端请求阿里云校验接口校验通过→注册成功；失败→提示错误

四、代码编写思路与逐段解析（为什么这么写？）

本套代码严格按照阿里云官方规范 + WordPress 安全规范编写，杜绝语法错误、站点崩溃、接口报错。

代码整体结构（7 大模块，各司其职）

1. 基础配置：定义固定参数，调用宝塔密钥
2. 签名算法：阿里云强制要求，鉴权专用（不可修改）
3. 发送验证码函数：调用阿里云发送接口
4. 校验验证码函数：调用阿里云校验接口
5. 前端表单：注册页展示输入框（无语法错误写法）
6. REST 接口：WordPress 提供后端调用入口
7. 注册校验：绑定 WordPress 注册流程，验证验证码

关键编写原则（小白必看）

1. 密钥分离：AK/SK 放宝塔，不写在主题文件（防泄露、防重复定义报错）
2. 无混写语法：用 echo <<<HTML 输出前端代码，避免 ?> 切标签导致的致命错误
3. 系统生成验证码：不自己写随机数，阿里云生成保证校验一致
4. 双重校验：前端 + 后端都校验手机号，防恶意请求
5. 最小改动：只改参数，不改核心算法，100% 兼容官方接口

五、【小白专属】代码粘贴绝对路径 + 具体位置

1. 绝对路径（宝塔面板可视化操作）

1. 登录 宝塔面板
2. 点击左侧 → 网站
3. 找到你的网站 → 点击 根目录
4. 依次打开文件夹：

wp-content → themes → generatepress → functions.php

✅ 最终文件路径：

/www/wwwroot/你的网站域名/wp-content/themes/generatepress/functions.php

2. 具体粘贴位置（零错误）

1. 用宝塔文件编辑器打开 functions.php
2. 把页面拉到最底部
3. 直接粘贴全部代码（如果文件最后有 ?>，粘贴在它的上方；没有就直接粘最后）
4. 点击 保存 → 完成部署

六、完整可直接复制的最终代码（无报错、稳定版）

代码严格按照阿里云官方规范 + WordPress 安全规范编写，杜绝语法错误、站点崩溃、接口报错，实测无任何兼容问题。注意更换你自已的ACCESS_KEY_ID和ACCESS_KEY_SECRET

// ==============================================
// 阿里云个人开发者短信认证（最终无错版）
// 宝塔里需要定义：ALIYUN_ACCESS_KEY_ID / ALIYUN_ACCESS_KEY_SECRET;
// 定义路径文件/www/wwwroot/网站名称/wp-config.php, 在/* That's all, stop editing! Happy publishing. */前面输入
// 阿里云短信服务配置
//define( 'ALIYUN_ACCESS_KEY_ID',     '你的ACCESS_KEY' );
//define( 'ALIYUN_ACCESS_KEY_SECRET', '你的ACCESS_KEY_SECRET' );
// ==============================================
​
// 仅配置必填项
define('ALIYUN_SIGN_NAME', '速通互联验证码');
define('ALIYUN_ENDPOINT', 'dypnsapi.aliyuncs.com');
​
// 阿里云官方签名算法
function aliyun_sign($params, $access_secret) {
    ksort($params);
    $query_str = '';
    foreach ($params as $key => $value) {
        $query_str .= '&' . rawurlencode($key) . '=' . rawurlencode($value);
    }
    $query_str = ltrim($query_str, '&');
    $string_to_sign = 'GET&%2F&' . rawurlencode($query_str);
    return base64_encode(hash_hmac('sha1', $string_to_sign, $access_secret . '&', true));
}
​
// ====================== 发送验证码（严格按你给的参数+无语法错误） ======================
function aliyun_send_sms_verify_code($mobile) {
    $params = [
        'Action'           => 'SendSmsVerifyCode',
        'Version'          => '2017-05-25',
        'PhoneNumber'      => $mobile,
​
        // 赠送签名配置
        'SignName'         => ALIYUN_SIGN_NAME,
​
        // 赠送模板配置
        'TemplateCode'     => '100001',
​
        // 与OpenAPI Explorer一致
        'TemplateParam'    => '{"code":"##code##","min":"5"}',
​
        // 模板匹配参数
        'CodeType'         => 1,
        'CodeLength'       => 6,
        'ValidTime'        => 300,
        'Interval'         => 60,
​
        'AccessKeyId'      => ALIYUN_ACCESS_KEY_ID,
        'Timestamp'        => gmdate('Y-m-d\TH:i:s\Z'),
        'SignatureMethod'  => 'HMAC-SHA1',
        'SignatureVersion' => '1.0',
        'SignatureNonce'   => uniqid(),
        'Format'           => 'JSON',
    ];
​
    $params['Signature'] = aliyun_sign($params, ALIYUN_ACCESS_KEY_SECRET);
    $url = 'https://'.ALIYUN_ENDPOINT.'/?'.http_build_query($params);
​
    $ch = curl_init();
    // 修复致命错误：curl_setopt_array
    curl_setopt_array($ch, [
        CURLOPT_URL            => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_SSL_VERIFYPEER => false,
        CURLOPT_TIMEOUT        => 10,
    ]);
    $response = curl_exec($ch);
    $error = curl_error($ch);
    curl_close($ch);
​
    if ($error) return ['Code' => 'CURL_ERROR', 'Message' => $error];
    return json_decode($response, true);
}
​
// 校验验证码（官方标准）
function aliyun_check_sms_verify_code($mobile, $verify_code) {
    $params = [
        'Action'           => 'CheckSmsVerifyCode',
        'Version'          => '2017-05-25',
        'PhoneNumber'      => $mobile,
        'VerifyCode'       => (string)$verify_code,
        'CountryCode'      => 'cn',
        'AccessKeyId'      => ALIYUN_ACCESS_KEY_ID,
        'Timestamp'        => gmdate('Y-m-d\TH:i:s\Z'),
        'SignatureMethod'  => 'HMAC-SHA1',
        'SignatureVersion' => '1.0',
        'SignatureNonce'   => uniqid(),
        'Format'           => 'JSON',
    ];
​
    $params['Signature'] = aliyun_sign($params, ALIYUN_ACCESS_KEY_SECRET);
    $url = 'https://'.ALIYUN_ENDPOINT.'/?'.http_build_query($params);
​
    $ch = curl_init();
    // 修复致命错误：curl_setopt_array
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_SSL_VERIFYPEER => false,
        CURLOPT_TIMEOUT        => 10,
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}
​
// 前端表单
add_action('bp_before_registration_submit_buttons', function () {
    $api_url = esc_url(rest_url('aliyun/send-sms'));
    echo <<<HTML
    <div class="editfield">
        <label>手机号</label>
        <input type="tel" id="mobile" name="mobile" required>
    </div>
    <div class="editfield">
        <label>验证码</label>
        <div style="display:flex;gap:8px;">
            <input type="text" id="verify_code" name="verify_code" maxlength="6" required>
            <button type="button" id="send_sms">获取验证码</button>
        </div>
        <p id="sms_tip" style="font-size:12px;margin:5px 0;color:red;"></p>
    </div>
​
    <script>
    let isSending = false;
    document.getElementById('send_sms').onclick = async function () {
        const mobile = document.getElementById('mobile').value.trim();
        const btn = this;
        const tip = document.getElementById('sms_tip');
        tip.innerText = '';
​
        if (!/^1[3-9]\d{9}$/.test(mobile)) { tip.innerText = '手机号格式错误'; return; }
        if (isSending) return;
​
        isSending = true;
        btn.disabled = true;
        let timer = 60;
        btn.innerText = timer + '秒';
        const countDown = setInterval(() => {
            timer--; btn.innerText = timer + '秒';
            if (timer <= 0) { clearInterval(countDown); btn.innerText = '获取验证码'; btn.disabled = false; isSending = false; }
        }, 1000);
​
        try {
            const res = await fetch('$api_url', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ mobile }) });
            const data = await res.json();
            if (data.success) { tip.innerText = '发送成功'; tip.style.color = 'green'; }
            else { tip.innerText = data.message; tip.style.color = 'red'; clearInterval(countDown); btn.innerText = '获取验证码'; btn.disabled = false; isSending = false; }
        } catch (e) { tip.innerText = '网络异常'; clearInterval(countDown); btn.innerText = '获取验证码'; btn.disabled = false; isSending = false; }
    };
    </script>
HTML;
});
​
// 发送接口
add_action('rest_api_init', function () {
    register_rest_route('aliyun', '/send-sms', [
        'methods' => 'POST', 'permission_callback' => '__return_true',
        'callback' => function ($request) {
            $mobile = sanitize_text_field($request->get_param('mobile'));
            if (!preg_match('/^1[3-9]\d{9}$/', $mobile)) return ['success' => false, 'message' => '手机号格式错误'];
            $result = aliyun_send_sms_verify_code($mobile);
            return (isset($result['Code']) && $result['Code'] === 'OK') ? ['success' => true] : ['success' => false, 'message' => $result['Message'] ?? '发送失败'];
        }
    ]);
});
​
// 注册校验
add_action('bp_signup_validate', function () {
    if (!isset($_POST['mobile']) || !isset($_POST['verify_code'])) { bp_core_add_message('手机号/验证码不能为空', 'error'); return; }
    $result = aliyun_check_sms_verify_code($_POST['mobile'], $_POST['verify_code']);
    if (!isset($result['Code']) || $result['Code'] !== 'OK') bp_core_add_message($result['Message'] ?? '验证码错误', 'error');
});
​
/**
 * 文章内容半隐藏 + 仅登录解锁 + 防复制 + 美化提示（GeneratePress专用）
 */
​
// 1. 内容隐藏逻辑（未登录隐藏后半部分，登录直接看全文）
add_filter( 'the_content', 'custom_hide_content_login_only', 10 );
function custom_hide_content_login_only( $content ) {
    if ( ! is_single() || ! is_singular( 'post' ) ) {
        return $content;
    }
​
    // 登录用户直接显示全文
    if ( is_user_logged_in() ) {
        return $content;
    }
​
    // 可修改：公开内容比例（40表示前40%内容公开）
    $open_percent = 40;
​
    // 按字数分割内容，保留段落格式
    $content_clean = wp_strip_all_tags( $content );
    $split_length = round( mb_strlen( $content_clean ) * $open_percent / 100 );
    $open_content = mb_substr( $content_clean, 0, $split_length );
    $open_content = wpautop( $open_content );
​
    // 美化提示框 + 修复登录链接（彻底解决nonce_failure）
    $lock_html = '
    <style>
    .custom-content-lock {
        border: 1px solid #4158D0;
        background: #f0f4ff;
        padding: 22px;
        margin: 25px 0;
        border-radius: 10px;
        text-align: center;
    }
    .custom-content-lock p {
        margin: 0;
        font-size: 19px !important;
        line-height: 1.7;
        color: #2d3794;
        font-weight: 600;
    }
    .custom-content-lock a {
        color: #4158D0;
        text-decoration: underline;
        font-weight: 700;
    }
    .custom-content-lock a:hover {
        color: #222;
        text-decoration: none;
    }
    </style>
    <div class="custom-content-lock">
        <p>🔐 此内容需登录后查看完整全文，请 <a href="/wp-login.php">登录账号</a> 后浏览</p>
    </div>';
​
    // 组合输出公开内容+提示框
    return $open_content . $lock_html;
}
​
// 2. 未登录用户防复制（禁用右键+Ctrl+C+文本选择）
add_action( 'wp_head', 'custom_disable_copy_for_guest', 99 );
function custom_disable_copy_for_guest() {
    if ( ! is_single() || is_user_logged_in() ) {
        return;
    }
    echo '
    <style>
    .single-post .entry-content {
        user-select: none !important;
        -webkit-user-select: none !important;
        -moz-user-select: none !important;
        -ms-user-select: none !important;
    }
    </style>
    <script>
    document.addEventListener("contextmenu", e => e.preventDefault());
    document.addEventListener("keydown", e => {
        if ((e.ctrlKey || e.metaKey) && (e.key === "c" || e.key === "C")) {
            e.preventDefault();
        }
    });
    </script>';
}

七、调试踩坑全记录（所有报错 + 解决方案）

八、为什么不付费也能发送短信？（官方免费政策）

1. 新用户专属福利：个人实名账号自动获得 100 条免费短信额度，有效期 12 个月
2. 失败不计费：调试、手机号错误、频率超限等失败场景，完全不扣费
3. 校验接口免费：验证码校验功能永久免费，仅发送接口计费
4. 个人专属：号码认证服务专为个人开发者设计，零门槛使用

九、安全规范与后续维护

1. 密钥绝对不能写在代码里，必须放宝塔环境变量
2. 免费额度用完后，可购买低价套餐（3.99 元 / 100 条）
3. 不要修改签名算法、接口参数，严格使用官方配置
4. 前端倒计时 + 后端频率限制，防止恶意刷短信

十、最终成功验证步骤

1. 保存 functions.php 文件
2. 打开网站注册页
3. 输入手机号 → 点击获取验证码
4. 手机收到短信
5. 输入验证码 → 提交注册

十一、总结

本套方案是个人开发者接入短信验证码的最优解，全程实测验证：

✅ 零企业资质 ✅ 零审核 ✅ 零成本 ✅ 零语法错误

✅ 复制粘贴即用 ✅ 小白友好 ✅ 永久稳定复用

所有代码、路径、逻辑均经过实战调试，直接按照文档操作，100% 成功！

1. 解压安装压缩包

2. 管理员权限打开setup

3. 安装Ansys License manager, ok

4. 同意, 下一个

5. 设定安装目录

6. 下一步、下一步

7. 不要勾选退出时启动授权管理中心，继续

8. 点击退出

9. 回到安装包位置，复制Ansys Inc文件夹

10. 安装文件夹粘贴替换

11.开始菜单打开Ansys License Managerment Center

12.在网页页面复制Mac Address

13. 安装包位置Crack下License替换Mac address

14. 网页Add a License File安装License, 然后退出

15. 正式安装Ansys产品

16. 同意，下一个

17. 下一个

18. 输入localhost, 下一个

19. 下一个，

20. 下一个，

21. 下一步，浏览选择3文件夹

22.下一个

23.安装包step2复制Ansys inc文件夹

24. 安装文件夹粘贴替换，安装完成

25. 开始菜单拉取Workbench到桌面快捷方式，双击打开即可。

DiskGenius备份系统c盘

1. Ventory u盘插入电脑, u盘启动，u盘里有winPE
2. 进入系统后打开DiskGenius，c盘盘符可能会变，如图系统(2)

3. 选择系统2盘右键,选择备份分区到镜像文件

3.1 选择文件路径：选择一个其它盘的路径备份，执行开始

3.2 也可以备份ESP引导分区，里面主要是C盘的引导文件

DiskGenius恢复系统c盘

1. 重启电脑到pe界面
2. 选中需要恢复的系统C盘，这里是系统(2)盘，右键/从镜像文件还原分区

选中备份文件

选中还原时间点，开始即可

一般情况下ESP盘不需要恢复，如果启动有问题，也可以恢复下ESP盘

• 插件安装
  1. wordpress后台/插件/安装插件/搜索 Latest Posts Block, 安装并启用

2. wp后台/页面/添加页面，新增页面，标题:wordpress网站教程, 别名:wordpress-2。

3. 后台/添加文章/分类目录/ 添加分类wordpress教程, 别名:wordpress2

4. 后台页面/所有页面/选择页面wordpress网站教程并点击编辑进入以下页面。左上角点+号，输入Latest，中间选中文章时右下角出现设置选项，设置
   • Laout options: ListCategory: WordPress教程排序:从最新至最旧排序项目数量:10

5. 右下角设置其它选项: 可添加摘要: Display Excerpt, 按自己的想法选择

6. 页面/所有页面/选中wordpress教程并点击查看，访问网页，复制顶部链接地址WordPress网站教程 – 轩然阁
7. 最后到外观菜单里将相应的导航菜单地址更新掉即可。
8. 分类效果如下。

前置下载安装包省略，最好去官网下载

1. 接受许可，下一步

2. 接受许可，下一步

3. 目录设定一个大硬盘，建立猿来 0224 班虚拟机目录，更改至该目录

4. 取消两者，下一步

5.桌面快捷方式，直接下一步

开始安装

6.安装好后输入激活码，完成

7.默认打开界面默认打开界面

8.创建新的虚拟机

9.自定义安装

10.默认，下一步

11.稍后安装 OS.稍后安装 OS

12.选择 OS7

13.新虚拟机名字，目录

14.选择 CPU，内核选择 CPU，内核

15.内存选择

16.选择网络连接方式

17.默认选择

18.磁盘选择

19.磁盘大小 20G

20.默认界面认界面

21.默认

22.加载 centOS 镜像

23.下一步点击完成

24.开机后选择第一个，回车

25.语言英语语言英语

26.基本包设置

27.软件包，选择后左上角 Done

28.系统设置，默认选择，Done

29.网络连接设置

30.Begin0.Begin

31.Root 用户名密码

32.等待安装完毕，重启开机，开机后同意授权

33.隐私可以关掉

34.创建普通用户名及密码

二、CentOS 下载

1. 百度阿里云开发者社区，进入 OS 镜像下载

2. 选择 CenOS 版本，推荐 DVD-2009

三、磁盘分区演示

1. 新建虚拟机向导→选择磁盘
   • 创建新虚拟磁盘 (V)

2. 指定磁盘容量

3. 指定磁盘文件

4.已准备好创建虚拟机

5.选择 OS，同时注意打印机可以移除，要不然开机会检测

6.开机后如果没有鼠标，按 Ctrl+alt 键激活鼠标

7.分区设置

/boot：启动分区，系统的引导启动程序，必须放在这里，1G

8.分区方案：分 2 个分区（启动分区、根分区）

9.点两下 done，接受即可

10.分几个区以及给这个分区指定名字

11、点两下done,接受即可, 后面与上方安装相同

Done, Enjoy!

>>从硬盘插线到软路由sata接口开始安装说明

第一步：物理连接硬盘到你的设备

1. 安全断电：在操作前，请务必关闭你的软路由/主机设备电源。
2. 连接硬盘：
   • 将SATA数据线一端连接到硬盘的SATA接口，另一端连接到主板上空闲的SATA接口。
   • 将SATA电源线（来自电源）连接到硬盘的电源接口。确保连接牢固。
3. 开机进入PVE系统：连接好后，为设备上电，并确保正常启动进入PVE系统。

第二步：在PVE系统中识别新硬盘

现在，我们需要在PVE的命令行终端（Shell）里确认系统已经识别到了这块新硬盘。

1. 登录PVE的Web管理界面，点击右上角的 “Shell” 按钮，打开命令行终端。
2. 输入以下命令并回车，列出所有块存储设备：lsblk
3. 查看输出结果。你会看到类似 sda、sdb、nvme0n1 这样的设备名。其中：
   • 原有的系统盘通常较小。
   • 新连接的、容量符合你硬盘大小的那个设备（例如 sdb），就是你的新数据盘。 请记下它的设备名（如 /dev/sdb）。
4. （重要）获取硬盘的唯一ID：为了避免后续硬盘顺序变化导致的问题，我们使用硬盘的唯一ID来操作。输入命令：ls -l /dev/disk/by-id/在列表中，找到对应你新硬盘的那一行。它会包含硬盘的型号和序列号信息，通常以 ata- 或 scsi- 开头，并且不包含 -part 字样。例如：ata-Samsung_SSD_870_EVO_1TB_S6PTNM0TB12345。复制这个完整的ID。

第三步：在PVE Web界面将硬盘直通给飞牛OS

这里我们将物理硬盘直接“映射”给虚拟机，性能最好。

1. 关闭虚拟机：在PVE Web界面中找到你的飞牛OS虚拟机，先将其关机。
2. 添加硬盘：
   • 进入虚拟机的 “硬件” 选项卡。
   • 点击 “添加” -> “硬盘”。
3. 关键配置：
   • 总线/设备：选择 SATA 或 SCSI。对于NAS系统，SATA 兼容性最佳。
   • 高级：勾选以显示更多选项。
   • 存储：在下拉菜单中选择 “未使用的磁盘” 或直接填写路径。
   • 最关键一步：在 “磁盘映像” 或 “路径” 输入框中，粘贴或手动输入你刚才复制的硬盘ID路径。格式应为：/dev/disk/by-id/ata-Samsung_SSD_870_EVO_1TB_S6PTNM0TB12345（请替换为你自己复制的ID）
   • 其他选项保持默认，点击 “添加”。
4. 启动虚拟机：添加完成后，启动飞牛OS虚拟机。

第四步：在飞牛OS内部初始化新硬盘

1. 登录飞牛OS：通过浏览器访问飞牛OS的IP地址和管理界面。
2. 进入存储管理：在桌面上打开 “存储管理” 应用。
3. 识别硬盘：在磁盘列表中，你应该能看到两块硬盘：
   • 一块较小的，是系统盘（可能已显示为“已使用”或挂载为系统分区）。
   • 另一块容量很大的、状态为 “未初始化” 或 “未使用” 的新硬盘，这就是你刚直通的物理硬盘。
4. 初始化并创建存储池：
   • 选中这块新硬盘。
   • 点击 “初始化” 或 “创建存储池”。
   • 存储池类型：因为是单盘，选择 “Basic (单盘)”。
   • 文件系统：强烈建议选择 Btrfs，它是为NAS设计的功能强大的文件系统。
   • 确认格式化（因为是全新空盘，无数据风险）。
5. 创建共享文件夹：初始化完成后，进入 “文件管理” 或 “共享文件夹”，在新的存储池上创建你需要的共享文件夹（如“下载”、“媒体库”、“备份”等）。

⚠️ 重要提醒

• 确保是目标硬盘：在执行 lsblk 和选择硬盘ID时，务必根据硬盘容量和型号确认是你新加的那块空盘，避免误操作覆盖其他数据盘。
• 直通的好处：通过 by-id 路径直通物理硬盘，性能无损，且飞牛OS可以直接管理硬盘的SMART健康状态等功能。
• 无法识别怎么办：如果在飞牛OS里看不到新硬盘，请返回PVE，检查虚拟机硬件列表中该硬盘是否添加成功，并确认其总线类型是 SATA 或 SCSI。

至此，从物理插线到飞牛OS内可用的完整流程就结束了。如果过程中有任何一步出现意外情况，请随时告诉我具体现象，我会帮你一起排查。

飞牛NAS优化设置

你已经成功为飞牛OS添加了数据硬盘，这为搭建功能完整的NAS系统打下了坚实的基础。

为了让你能更好地使用和管理这块新的存储空间，这里有几个后续步骤和建议，或许能派上用场：

• 优化与数据保护
  • 设置共享文件夹权限：在飞牛OS的“用户”或“共享文件夹”设置中，可以为不同用户分配文件夹的访问权限（只读、读写等）。
  • 配置自动备份：可以利用飞牛OS内置的“备份”应用，将系统盘上的重要数据（如Docker配置、应用设置）定时备份到这块新的大容量数据盘上。
  • 启用硬盘休眠（可选）：如果希望节能，可以在飞牛OS的“存储管理”或“电源管理”中查看并设置硬盘休眠，但需注意频繁唤醒可能影响硬盘寿命。
• PVE层面的建议
  • 创建虚拟机备份：现在你的飞牛OS虚拟机包含了重要数据，建议在PVE中为它设置定期的备份任务（“备份”选项卡），将整个虚拟机状态备份到另一块硬盘或网络存储中。
  • 利用快照功能：在进行重大系统更新或配置更改前，可以在PVE中为飞牛OS虚拟机创建一个“快照”，如果操作出现问题，可以瞬间回滚到之前的状态。
• 探索飞牛OS的存储功能
  • 使用Btrfs高级功能：如果你在初始化时选择了Btrfs文件系统，之后可以在存储池上尝试启用快照功能，用于快速备份和恢复共享文件夹。
  • 为Docker/虚拟机配置存储：在飞牛OS中安装Docker或创建虚拟机时，可以将它们的存储路径设置在这块新数据盘上，避免占用系统盘空间。

实际输出

根据 ls -l /dev/disk/by-id/ 输出，可以看出系统里有一块SATA硬盘（sda）和一块NVMe固态硬盘（nvme0n1）。

对于 /dev/sda 这块硬盘，它对应两个ID，这两个ID都可以用来安全地直通给虚拟机：

1. ata-WDC_WD60EFPX-68JH4N1_WD-WC3K20AE5PWO
   • 说明：这是最标准的ATA（SATA）硬盘ID，由“ata-” + 硬盘型号（WDC_WD60EFPX-68JH4N1） + 硬盘序列号（WD-WC3K20AE5PWO）组成。
   • 含义：这是一块 西部数据（WDC）的6TB硬盘（从型号 WD60EFPX 判断），即你新添加的机械硬盘。这就是你要用的那个ID。
2. wwn-0x50014ee2b6d01775
   • 说明：这是硬盘的全球唯一名称（World Wide Name），也是一个完全唯一的标识符。
   • 含义：它与上面的ata- ID指向同一块物理硬盘（sda）。

💡 结论与操作建议

为了将这块全新的6TB硬盘直通给飞牛OS，你应该使用第一个ID：

/dev/disk/by-id/ata-WDC_WD60EFPX-68JH4N1_WD-WC3K20AE5PWO

为什么选这个？

• ata- 开头的ID最直观，明确显示了制造商和型号，便于人工核对，不易出错。
• 这是PVE社区在直通SATA硬盘时最常用、最推荐的方式。

下一步操作：

1. 在PVE Web界面，为飞牛OS虚拟机添加硬盘。
2. 在硬盘配置页面，总线选择 SATA。
3. 在“磁盘映像”或“路径”输入框中，完整粘贴上面的ID路径。
4. 完成添加并启动虚拟机，然后进入飞牛OS的“存储管理”进行初始化。

⚠️ 重要确认

请再次通过 lsblk 命令确认这块硬盘（sda）的容量是否是 6TB 左右，确保它是你新插入的那块空硬盘，而不是系统原本就在使用的硬盘（从你的列表看，系统很可能安装在NVMe固态 nvme0n1 上，所以 sda 应该就是新盘）。

确认无误后，就可以放心地使用这个ID进行直通了。如果在飞牛OS里初始化时找不到硬盘，可以随时再来询问。

在添加/硬盘下面，存储下面找不到未使用的磁盘

当PVE Web界面的“存储”下拉菜单中没有“未使用的磁盘”选项时，这通常是正常的，意味着PVE没有将这块硬盘识别为可用于创建虚拟磁盘的存储空间。不过这不影响你将硬盘直通给虚拟机，此时最直接可靠的方法是通过命令行（Shell）手动添加。

🔧 解决方案：使用命令行直通硬盘

1. 获取关键信息：
   • 虚拟机ID：在PVE网页左侧的节点树中，找到你的飞牛OS虚拟机，ID通常是101、102这样的数字。
   • 硬盘ID：根据你之前的查询，我们要用的是这块硬盘的ID：ata-WDC_WD60EFPX-68JH4N1_WD-WC3K20AE5PWO。
2. 执行直通命令： 打开PVE的Shell（网页右上角），输入以下命令（请替换 VMID 为你的虚拟机实际ID）：qm set <VMID> –sata1 /dev/disk/by-id/ata-WDC_WD60EFPX-68JH4N1_WD-WC3K20AE5PWO例如，如果你的虚拟机ID是101，命令就是：qm set 101 –sata1 /dev/disk/by-id/ata-WDC_WD60EFPX-68JH4N1_WD-WC3K20AE5PWO命令解释：qm set是修改虚拟机配置的命令，--sata1表示将硬盘添加到虚拟机的第2个SATA接口（SATA0通常被系统盘占用）。
3. 验证结果： 执行成功后，会有“update VMID…”的提示。你可以在网页上刷新虚拟机“硬件”选项卡，查看列表中是否多了一块类型为“硬盘”、总线为“SATA”的设备。

💡 Web界面与命令行方法对比

为了让你更清晰地了解两者的区别，可以参考下表：

📝 后续操作与确认

命令执行后，启动飞牛OS虚拟机，登录其“存储管理”，新硬盘应该会显示为一块未初始化的磁盘。你可以按照之前说明的步骤，在飞牛OS内部将其初始化为存储空间。

安全提示：

• 再次确认你使用的硬盘ID对应的是那6TB的空硬盘（sda），而非系统所在的NVMe固态硬盘（nvme0n1）。
• qm set命令是即时生效的。如果直通后发现选错了硬盘，可以使用命令 qm set <VMID> --delete sata1 来移除该设备。

飞牛硬盘安装好后，发现网络设置IPV4显示的是半双工，怎么改为全双工

“半双工”是个非常明确的信号，就像两个人用对讲机，同一时间只能一方说话，数据传输效率自然减半。我们的核心诉求是解决这个网络瓶颈，让飞牛OS发挥出应有的性能。需要从诊断原因到提供解决方案，给出一个清晰的路径。

首先考虑的是最可能的原因。根据经验，网卡协商模式异常、网线质量问题、路由器/交换机端口限制或PVE虚拟化配置问题都可能导致半双工。用户环境是PVE虚拟机，所以虚拟网络适配器的设置需要优先检查。

搜索结果的质量参差不齐。像CSDN这类技术社区，信息虽然相关但权威性一般，而且有些内容比较零散，没有形成系统性的排查步骤。我们需要整合这些信息点，结合自己的知识，构建一个从易到难、从软到硬的完整排查流程。

从最简单的步骤开始。首先检查飞牛OS内部的网络设置，看看有没有强制模式的选项。然后快速排查物理层的网线和交换机端口，这是常见隐患点。接着深入到PVE的虚拟网络配置，这是用户环境特有的环节。最后再考虑更新驱动或调整更底层的PVE主机设置。这样一步步推进，操作起来会更有条理，也容易定位问题所在。

同时，我们需要记录当前的网络速度，以便和修复后的效果对比。毕竟“提高网速”是个相对目标，有数据对比才能明确改进效果。

在飞牛OS中看到IPv4显示为“半双工”，这确实是导致网络速度慢的关键原因。半双工意味着数据不能同时收发，网络效率会直接减半。

别担心，这通常不是硬件损坏，而是网络“协商”出了问题。我们可以按照从易到难的顺序，系统地排查和解决。

🔍 问题诊断与解决步骤

你可以按照以下流程图所示的路径，一步步排查，高效定位问题：

下面是对图中关键步骤的详细说明：

第一步：检查物理连接（最优先） 这是最常见的原因，请务必先检查：

1. 网线：更换一根质量可靠的超五类（Cat 5e）或更高规格的网线。劣质网线或线序错误极易导致协商降级。
2. 网口与交换机：将连接飞牛OS的网线，更换到路由器或交换机的另一个端口试试。有些交换机的特定端口可能存在问题。

第二步：检查PVE虚拟网络配置 由于飞牛OS运行在PVE虚拟机中，虚拟网卡的设置至关重要。

1. 关机并检查网卡模型：在PVE Web界面，关闭飞牛OS虚拟机，进入其 “硬件” 选项卡，查看网络设备（net0）的 “模型”。
   • 最优选择：VirtIO (半虚拟化)。性能最好，但需要客户机系统（飞牛OS）有驱动。
   • 兼容选择：Intel E1000 或 VMware vmxnet3。兼容性极佳，通常能稳定协商为千兆全双工。
   • 操作：如果不是以上模型，建议删除现有网卡，重新添加一个，并将模型改为 Intel E1000 进行测试。
2. 调整MTU值：在同一个编辑界面，尝试将MTU值设置为标准的 1500。如果你确认整个网络环境（所有网卡、交换机）支持巨帧，也可以尝试 9000，但设置错误会导致网络中断，需谨慎。

第三步：在飞牛OS内部尝试固定模式 如果上述步骤无效，可以尝试在飞牛OS内部强制指定模式（这并非最优解，但可用于测试）。

1. 你需要通过 SSH 登录飞牛OS（通常需要在飞牛OS的“系统设置”中启用SSH服务）。
2. 使用 ethtool 命令查看当前网卡状态（飞牛OS基于Linux，通常自带此命令）：ethtool eth0查看输出中的 “Speed”、“Duplex” 和 “Auto-negotiation” 字段。
3. 理论上，你可以用以下命令强制设置为千兆全双工（不推荐长期使用，仅用于诊断）：ethtool -s eth0 speed 1000 duplex full autoneg off注意：飞牛OS作为NAS系统，其网络配置界面可能较简化，强制设置可能在重启后失效，或与PVE层配置冲突，导致失联。请谨慎操作。

第四步：更新PVE主机与驱动 如果所有软硬件设置都正确但问题依旧，可能需要更新底层驱动。

1. 更新PVE系统：在PVE Shell中执行 apt update && apt dist-upgrade 更新系统，重启PVE主机。
2. 检查PVE主机网卡驱动：在PVE Shell执行 lspci -v | grep -iA 10 ethernet，查看物理网卡型号和驱动。搜索该型号是否有已知问题或需要更新驱动。

📊 如何验证结果？

在飞牛OS的“网络设置”或通过SSH执行 ethtool eth0 命令，成功解决后，你应该能看到：

• Speed: 1000Mb/s
• Duplex: Full
• Auto-negotiation: on （理想状态）

⚠️ 重要提醒

在整个排查过程中，每次只进行一项修改，并测试网络状态，这样能准确定位是哪个步骤解决了问题。

请先尝试第一步和第二步（更换网线、端口和调整PVE虚拟网卡模型），这能解决90%的类似问题。

精简步骤：

第一步：PVE里输入命令识别

lsblk
ls -l /dev/disk/by-id/
​
#找到如下ID
ata-WDC_WD6005FFBX-68CASN0_WD-AN3GEH1N
​
#使用以下命令挂载
root@pve:~# qm set 101 --sata1 /dev/disk/by-id/ata-WDC_WD6005FFBX-68CASN0_WD-AN3GEH1N
update VM 101: -sata1 /dev/disk/by-id/ata-WDC_WD6005FFBX-68CASN0_WD-AN3GEH1N

第二步：在PVE Web界面将硬盘直通给飞牛OS

这里我们将物理硬盘直接“映射”给虚拟机，性能最好。

1. 关闭虚拟机：在PVE Web界面中找到你的飞牛OS虚拟机，先将其关机。
2. 添加硬盘：
   • 进入虚拟机的 “硬件” 选项卡。
   • 点击 “添加” -> “硬盘”。
3. 关键配置：
   • 总线/设备：选择 SATA 或 SCSI。对于NAS系统，SATA 兼容性最佳。
   • 高级：勾选以显示更多选项。
   • 存储：在下拉菜单中选择 “未使用的磁盘” 或直接填写路径。
   • 最关键一步：在 “磁盘映像” 或 “路径” 输入框中，粘贴或手动输入你刚才复制的硬盘ID路径。格式应为：text/dev/disk/by-id/ata-WDC_WD6005FFBX-68CASN0_WD-AN3GEH1N（请替换为你自己复制的ID）
   • 其他选项保持默认，点击 “添加”。
4. 启动虚拟机：添加完成后，启动飞牛OS虚拟机。

第三步：在飞牛OS内部初始化新硬盘

1. 登录飞牛OS：通过浏览器访问飞牛OS的IP地址和管理界面。
2. 进入存储管理：在桌面上打开 “存储管理” 应用。
3. 识别硬盘：在磁盘列表中，你应该能看到两块硬盘：
   • 一块较小的，是系统盘（可能已显示为“已使用”或挂载为系统分区）。
   • 另一块容量很大的、状态为 “未初始化” 或 “未使用” 的新硬盘，这就是你刚直通的物理硬盘。
4. 初始化并创建存储池：
   • 选中这块新硬盘。
   • 点击 “初始化” 或 “创建存储池”。
   • 存储池类型：因为是单盘，选择 “Basic (单盘)”。
   • 文件系统：强烈建议选择 Btrfs，它是为NAS设计的功能强大的文件系统。
   • 确认格式化（因为是全新空盘，无数据风险）。
5. 创建共享文件夹：初始化完成后，进入 “文件管理” 或 “共享文件夹”，在新的存储池上创建你需要的共享文件夹（如“下载”、“媒体库”、“备份”等）。