# 系统准备

## 系统软件源镜像配置

本次我的机器使用的是Centos，所以软件源需要切换到vault软件源

```
sudo sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
sudo sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
```

## 更新系统并安装基本工具

可根据各自的系统安装以下内容
```bash
sudo dnf update -y
sudo dnf install -y epel-release
sudo dnf install -y wget git gcc kernel-devel-$(uname -r) kernel-headers-$(uname -r)
```

epel-release: 提供额外的软件包。  
gcc, kernel-devel, kernel-headers: 这些是编译 NVIDIA 驱动所必需的。$(uname -r) 会确保安装与你当前运行的内核版本匹配的头文件。




# 安装显卡驱动

## 禁用冲突驱动

如果有Nouveau 驱动，他会与 NVIDIA 官方驱动冲突，必须禁用。

```bash
sudo bash -c "echo 'blacklist nouveau' > /etc/modprobe.d/blacklist-nouveau.conf"
sudo bash -c "echo 'options nouveau modeset=0' >> /etc/modprobe.d/blacklist-nouveau.conf"
```

更新内核initramfs并重启机器：
```bash
sudo dracut --force
sudo reboot
```

## 下载NVIDIA驱动

### 显卡型号查询

如果不知道自己是什么型号的显卡，可以通过该方式查询

```bash
lspci | grep -i nvidia

# 如果上面命令没有输出，可使用该命令
lspci | grep -i vga
```
这里我查询出，该机器安装的显卡为 A10
![image.png](https://oss.silon.vip/img/43d92097aa6c464dc85431b511b14a99.image.webp)

### 驱动下载
知道显卡型号后，就可以去NVIDIA官网下载对应的驱动了

https://www.nvidia.com/Download/index.aspx
![image.png](https://oss.silon.vip/img/6c02b456467297d4d6f74a98c265426f.image.webp)

根据自己的显卡型号，选择对应的序列，我这里A10属于服务器显卡，安装在Linux64位系统中

点击 find， 可以进入到该驱动下载页面
![image.png](https://oss.silon.vip/img/456cf2e9985d85e5fddaa52376b5e4f3.image.webp)


如果需要使用服务器下载，可以右键获取下载链接，使用wget下载到当前目录
```bash
# 注意，这里的链接需要更换为右键复制的链接
wget https://us.download.nvidia.com/xxxxxxx.run
```

### 安装驱动

cd 到驱动文件的目录中，执行以下操作

```bash
# 给下载的文件添加执行权限
# 同样，文件名请替换为你下载的实际文件名
chmod +x NVIDIA-Linux-xxxxxx.run

# 运行安装程序
# --no-opengl-files 选项对于纯计算服务器很重要，可以避免覆盖系统库
sudo ./NVIDIA-Linux-xxxxxx.run --no-opengl-files
```

如果提示安装 32-bit 兼容库, 选择 No (除非你有特殊需求)。
其他基本一路使用默认选项或确认即可。

![image.png](https://oss.silon.vip/img/e9b49513202439afaf62f06d5e1967ad.image.webp)


至此就已经完成安装了，不需要重启服务器

### 验证安装

完成安装后，就可以使用NVIDIA的驱动命令来进行显卡状态的查询了
```bash
nvidia-smi
```

![image.png](https://oss.silon.vip/img/50da5a9931fa4267bb01038231a6a61c.image.webp)


# 其他

## 安装 NVIDIA Container Toolkit (让 Docker 使用 GPU)

```bash
# 添加 NVIDIA 容器工具仓库
curl -s -L https://nvidia.github.io/libnvidia-container/centos8/libnvidia-container.repo | sudo tee /etc/yum.repos.d/nvidia-container-toolkit.repo
# 安装工具包
sudo dnf install -y nvidia-docker2
# 重启 Docker 服务使配置生效
sudo systemctl restart docker
```

![image.png](https://oss.silon.vip/img/e16de5943639067763eb477ea31659c1.image.webp)


修改 /etc/docker/daemon.txt
```
{
    "runtimes": {
        "nvidia": {
            "path": "nvidia-container-runtime",
            "runtimeArgs": []
        }
    },
    "registry-mirrors": [
    ],
    "default-runtime": "nvidia"
}
```

"default-runtime": "nvidia" 告诉 Docker 默认就使用 NVIDIA 运行时

这样在 docker-compose.yml 中就不再需要复杂的 runtime: nvidia 配置。

linux 服务器安装gpu驱动

### **一、 webdav 和网盘的关系**

**WebDAV**不是又一个新的网盘服务，而是一种经典、开放且强大的技术协议

只要是存储系统，都可以使用 webdav 作为标准访问接口，让任何支持 webdav 的客户端访问存储系统。

它就像一把神奇的钥匙，能让你将家里的电脑、NAS 或任何一台服务器，变成一个完全由你掌控的、跨平台的“私人数据中心”。



### **二、 什么是 WebDAV？—— 你的私人“云”钥匙**

简单来说，WebDAV (Web-based Distributed Authoring and Versioning) 是一个诞生于上世纪的互联网标准协议。

别被它拗口的名字吓到，你可以把它想象成：

*   **一个“网络U盘”**：它让你可以像访问本地文件夹一样，通过网络直接读取、写入、修改服务器上的文件。
*   **一扇“通用大门”**：因为它是一个开放标准，无数的 App 和设备都支持它。无论是苹果、安卓还是Windows，无论是笔记软件、视频播放器还是文件管理器，都可以通过这扇门，访问你同一个数据仓库。

它的核心优势，正是我们这个时代最稀缺的东西：`数据私有`、`开放通用`、`成本低廉`。

### **三、 为什么选择 WebDAV？—— 四大核心应用场景**

WebDAV 的魅力不在于它技术有多新潮，而在于它能切实解决我们数字生活中的具体问题。

#### **场景一：多平台笔记同步的心脏 (for Obsidian, Joplin)**

对于像 Obsidian、Joplin 这样的笔记软件用户来说，WebDAV 是实现多设备同步的“平价法拉利”。你不再需要依赖昂贵的官方同步服务，只需简单配置，就能让你的知识库在手机、平板和电脑间无缝漫游，安全又私密。

#### **场景二：科研与学习的利器 (for Zotero)**

Zotero 用户的普遍痛点是免费的附件同步空间（300MB）捉襟见肘。而通过 WebDAV，你可以将 Zotero 的文献附件指向自己的服务器。这意味着你的文献库空间可以无限扩展——你的硬盘有多大，空间就有多大！

#### **场景三：私人影音库的遥控器 (for nPlayer, Infuse)**

想象一下，你家里的 NAS 或服务器上存着上百G的高清电影和剧集。有了 WebDAV，你只需在手机或平板的 nPlayer、Infuse 等播放器里添加一个地址，就能随时随地在线播放它们，无需下载，即点即看，如同拥有一个私人的 Netflix。

#### **场景四：跨平台文件访问的桥梁**

随时随地，打开手机上的文件管理器（如 Solid Explorer），就能直接访问、管理你家里电脑的文件。临时需要一份报告？打开手机就能取用。想给朋友分享一张照片？直接从服务器上就能分享，无需先下载到手机。

### **四、 如何搭建？—— Docker 部署，轻松拥有**

对于现代玩家而言，Docker 是部署服务的最佳方式，它干净、独立、迁移方便。我们将介绍两种主流的、通过 Docker 搭建 WebDAV 服务的方法：**Alist** 和 **Nextcloud**。

#### **方案一：Alist —— 轻量而强大的文件列表与 WebDAV 中心**

Alist 是一个神奇的程序，它能挂载多种网盘（阿里云盘、百度网盘等）和本地存储，并提供一个统一的、美观的列表界面，同时，它也内置了强大的 WebDAV 服务。

**操作步骤：**

1.  在家里的电脑或服务器上创建一个文件夹，例如 `alist`。
2.  在 `alist` 文件夹内，创建一个名为 `docker-compose.yml` 的文件，并粘贴以下内容：

    ```yaml
    version: '3.3'
    services:
        alist:
            image: 'xhofe/alist:latest'
            container_name: alist
            volumes:
                - './data:/opt/alist/data' # 将配置文件映射到当前目录的data文件夹
            ports:
                - '5244:5244' # 冒号左边的 5244 可以改成你喜欢的任何未被占用的端口
            restart: always
            environment:
                - PUID=0
                - PGID=0
                - UMASK=022
    ```

3.  在该目录下打开终端（或命令提示符），运行命令：`docker-compose up -d`
4.  等待片刻，Alist 就运行起来了。访问 `http://你的IP地址:5244`，后台管理页面会提示你初始管理员密码。
5.  登录后，务必先修改密码。然后在“存储” -> “添加”中，选择“本机存储”，填入挂载路径 `/opt/alist/data`（或其他你想暴露的服务器路径），即可将本地文件夹通过 Alist 管理。
6.  Alist 的 WebDAV 服务是自动开启的，地址通常是 `http://你的IP地址:5244/dav`。

#### **方案二：Nextcloud —— 功能全面的私人云套件**

Nextcloud 不仅仅是一个 WebDAV 服务，它是一整套开源的私人云解决方案，包含了文件同步、日历、联系人、在线Office等功能，堪称“自建的 Google Drive”。

**操作步骤：**

1.  同样，创建一个 `nextcloud` 文件夹，并在里面新建 `docker-compose.yml` 文件：

    ```yaml
    version: '3'
    services:
      db:
        image: postgres:latest
        restart: always
        volumes:
          - ./db:/var/lib/postgresql/data
        environment:
          - POSTGRES_DB=nextcloud
          - POSTGRES_USER=nextcloud
          - POSTGRES_PASSWORD=your_strong_password_here # 请务必修改成一个安全的密码
  
      app:
        image: nextcloud:latest
        restart: always
        ports:
          - 8080:80 # 冒号左边的 8080 可以改成你喜欢的端口
        links:
          - db
        volumes:
          - ./nextcloud:/var/www/html
        environment:
          - POSTGRES_HOST=db
          - POSTGRES_DB=nextcloud
          - POSTGRES_USER=nextcloud
          - POSTGRES_PASSWORD=your_strong_password_here # 和上面数据库的密码保持一致
    ```

2.  在该目录下运行命令：`docker-compose up -d`
3.  首次访问 `http://你的IP地址:8080`，会进入 Nextcloud 的安装向导。创建一个管理员账户，然后在数据库配置部分，选择 PostgreSQL，并填入上面 `docker-compose.yml` 文件中你设置的数据库信息（数据库用户、密码、名称都是 `nextcloud`，主机是 `db`）。
4.  安装完成后，登录你的 Nextcloud。在左下角“设置” -> “移动与桌面设备”里，你就能找到你的专属 WebDAV 地址。它通常是这样的格式：`http://你的IP地址:8080/remote.php/dav/files/你的用户名/`

**Alist vs Nextcloud 如何选？**
*   **选 Alist**：如果你只想拥有一个轻量、快速、能统一管理多种存储并提供 WebDAV 接口的工具。
*   **选 Nextcloud**：如果你需要一个功能全面的私人办公和生活协作套件，WebDAV 只是其中一项功能。

### **五、 如何使用？—— 全平台客户端配置指南**

配置 WebDAV 客户端非常简单，万变不离其宗，你只需要记住四个关键信息：

> **WebDAV 配置四要素：**
> *   **服务器地址：** `http://<你的IP或域名>:<端口号>`
> *   **路径 (Path)（如果有的话）：** 例如 Alist 是 `/dav`，Nextcloud 是 `/remote.php/dav/files/用户名/`
> *   **用户名：** 你的登录账号
> *   **密码：** 你的登录密码

以 nextcloud 为例


![image.png](https://oss.silon.vip/img/8df759399bc8ae308237d22e9d117b4e.image.webp)

![image.png](https://oss.silon.vip/img/bcdd4cadca57db1a07c90c9082474112.image.webp)


这里就是 webdav 的 地址
用户名和密码则为 nextcloud 的用户账号和密码

为了安全起见，建议为 webdav 专门注册一个 app 授权，不使用用户的默认密码



**各平台推荐应用：**

![image.png](https://oss.silon.vip/img/2266dbb93f4798a3fcd16d665b0eefdd.image.webp)


### **六、 避坑指南：使用 WebDAV 必须知道的事**

享受自由的同时，责任也随之而来。请务必牢记以下几点：

1.  **安全第一：公网访问必须使用 HTTPS！**
    如果你打算在外网访问你的 WebDAV，直接使用 HTTP 等于在互联网上“裸奔”，账号密码和数据都可能被窃取。请务必使用 Nginx Proxy Manager 或 Caddy 等反向代理工具，为你的服务套上一个免费的 SSL 证书，实现 HTTPS 加密访问。

2.  **性能认知：它并非万能**
    WebDAV 非常适合看电影、同步笔记附件等大文件和低频次操作。但它不适合同步大量、细碎的文件（如代码项目），这种场景下，专业的同步工具 Syncthing 会是更好的选择。

3.  **数据备份：自建不等于高枕无忧**
    切记：**WebDAV 是访问方式，不是备份方案！** 你的服务器硬盘可能会损坏。请务必为你的重要数据建立独立的备份策略，例如使用 NAS 的 RAID，或定期将数据备份到另一块硬盘或云端。

webdav搭建及基本使用

gunicorn 使用及常见工程化配置

在团队开发中，pre-commit 是非常常用的代码质量保障工具。但不少 Windows 用户在使用 pre-commit 时，会遇到 `ExecutableNotFoundError: Executable /bin/sh not found` 的报错。本文将详细分析原因，并给出完整的解决方案。




## 1. 问题现象

在 Windows 下执行 `git commit` 时，出现如下报错：

```
An unexpected error has occurred: ExecutableNotFoundError: Executable `/bin/sh` not found
Check the log at C:\Users\用户名\.cache\pre-commit\pre-commit.log
```

pre-commit.log 里会有类似堆栈：

```
pre_commit.parse_shebang.ExecutableNotFoundError: Executable `/bin/sh` not found
```

## 2. 问题原因分析

### 2.1 pre-commit hook 兼容模式

pre-commit 在安装时，如果检测到 `.git/hooks/pre-commit.legacy` 文件，会进入兼容模式（migration mode），优先执行 legacy hook。很多老的 hook 脚本是 shell 脚本，shebang 为 `/bin/sh`，而 Windows 没有这个解释器，导致报错。

### 2.2 配置 language: system

如果 pre-commit hook 配置为 `language: system`，pre-commit 可能会尝试用 shell 执行 entry，也会导致依赖 `/bin/sh`。

### 2.3 entry 配置不当

如果 entry 只写了命令名（如 `pylint`），部分 pre-commit 版本会用 shell 执行，间接依赖 `/bin/sh`。

## 3. 解决方案

### 3.1 删除 legacy hook

进入项目的 `.git/hooks` 目录，删除 `pre-commit.legacy` 文件：

```powershell
Remove-Item .git\hooks\pre-commit.legacy
```

### 3.2 强制重新安装 pre-commit hook

```powershell
pre-commit install -f
```

这样只会用 pre-commit 的 hook，不再兼容老的 shell 脚本。

### 3.3 修改 .pre-commit-config.yaml 配置

推荐将 `language` 设置为 `python`，并将 `entry` 改为 `python -m pylint`，如下：

```yaml
- repo: local
  hooks:
    - id: pylint
      name: pylint
      entry: python -m pylint
      language: python
      types: [python]
      args: [
          "--rcfile=pyproject.toml",
          "-rn", # Only display messages
          "-sn", # Don't display the score
        ]
```

这样 pre-commit 会直接用 Python 解释器运行，不再依赖 shell。

### 3.4 检查其他 hook

如果还有其他 hook（如 trailing-whitespace、end-of-file-fixer 等），请确认它们是否需要 shell 环境。大部分 Python 相关的 hook 都能在 Windows 下正常运行。

### 3.5 升级 pre-commit

确保 pre-commit 版本为 4.x 及以上：

```powershell
pip install -U pre-commit
```

### 3.6 清理 pre-commit 缓存

```powershell
pre-commit clean
```


## 4. 总结

Windows 下 pre-commit 报 `/bin/sh not found`，99% 是 legacy hook 或配置问题。只要：

- 删除 legacy hook
- 配置 language: python，entry: python -m xxx
- 强制安装 pre-commit hook

即可彻底解决。

Windows 下 pre-commit 报 `/bin/sh not found` 问题全解析与解决方案

系统准备

系统软件源镜像配置

更新系统并安装基本工具

一、 webdav 和网盘的关系

Gunicorn 使用及常见工程化配置

1. 什么是 Gunicorn？

Python 代码标准化工程实践