如何在群晖NAS上安装Python的MariaDB连接器

云上老周

2026-7-24

在群晖DS718Plus上安装Python MariaDB模块

当然可以安装，以下是具体操作步骤：

确认Python环境路径
SSH登录群晖后，执行以下命令确认你正在使用的Python3路径和版本：
```
which python3
python3 --version
```
群晖套件中心安装的Python3通常路径类似/volume1/@appstore/Python3/bin/python3，系统自带的则多为/usr/bin/python3。
使用pip安装mariadb模块
根据你确认的Python路径，调用对应的pip3执行安装：
- 若为套件中心安装的Python，执行：
```
/volume1/@appstore/Python3/bin/pip3 install mariadb
```
- 若为系统自带Python，先确保pip可用再安装：
```
python3 -m ensurepip --upgrade
pip3 install mariadb
```
解决编译依赖问题
如果安装时出现找不到mysql.h这类编译错误，说明缺少MariaDB开发依赖：
- 打开群晖套件中心，搜索并安装MariaDB 10 Development Files套件（部分DSM版本命名可能略有差异）；
- 若套件中心无对应包，可尝试通过SSH执行：
```
sudo apt-get update
sudo apt-get install libmariadb-dev
```
  （注：DSM 7及以上版本可能需要先启用Debian源，操作前请确认风险）
验证安装结果
执行以下命令验证模块是否安装成功：
```
python3 -c "import mariadb; print('MariaDB模块安装成功')"
```
无报错则说明模块已正常安装，之后即可在SSH环境下运行你的Python数据库程序。