华硕 華碩 TUF Docker安装教程（Ubuntu/CentOS）

dctc_shouhuzhe

## 概述

华硕 TUF Gaming 系列 NAS 以其军工级耐久性和稳定的 Linux 底层著称，广泛应用于小型工作室、极客玩家以及中小企业的私有存储方案。Docker 容器化技术的引入，使得 TUF NAS 不再仅仅是文件存储设备，更成为一台可运行多种服务的一体化服务器。本文详细记录在 Ubuntu 与 CentOS 系统上为 TUF NAS 安装 Docker 的完整流程，涵盖环境准备、存储驱动配置、镜像加速、常用服务部署及常见问题排查，覆盖从零到生产可用的完整链路。

---

## 华硕 TUF NAS 硬件与系统概述

华硕 TUF Gaming NAS 产品线以 TUF Gaming 品牌为标识，硬件层面采用 Intel 或 AMD 处理器，标配双千兆网口并支持链路聚合，扩展槽涵盖 SATA 与 NVMe 混插配置。系统层面，该系列默认运行基于 Open Source Storage OS 的定制 Linux 发行版，用户拥有完整的 root 访问权限，这为直接安装 Docker 提供了技术前提。

需要明确的是，华硕官方 NAS 系统（如 ADM）默认不提供 Docker 桌面入口，但 TUF NAS 允许通过 SSH 登录后手动部署 Docker Engine。对于已刷写标准 Linux 发行版（Ubuntu Server 或 CentOS Stream）的 TUF 硬件设备，本文方案可直接适用；若使用华硕原生系统，则需通过虚拟化环境（如 VirtualBox within DSM 或 Proxmox VE）间接运行 Docker，路径差异较大，本文不做展开。

### 前提条件

- TUF NAS 已安装 Ubuntu 22.04/24.04 LTS 或 CentOS Stream 8/9
- 具备 sudo 或 root 权限的管理账户
- 稳定的网络连接（国内网络需配置镜像加速）
- 建议 NAS 具备至少 4GB RAM，8GB 以上为生产环境推荐配置

### 硬件兼容矩阵

| 组件 | 兼容型号 | 注意事项 |
|------|----------|----------|
| 处理器 | Intel Core i3/i5/i7 第10代后、AMD Ryzen 5/7 | 老旧型号可能缺少某些容器化特性支持 |
| 内存 | 8GB+ DDR4 | 低于4GB可能导致Docker守护进程启动失败 |
| 存储控制器 | Intel RST、AMD RAID | 部分RAID模式需切换为AHCI才能正常使用Docker存储驱动 |
| 网卡 | Intel i211/i218V、Realtek RTL8111 | Realtek网卡在Ubuntu下需额外安装驱动 |
| USB接口 | USB 3.0/3.1 | 华硕TUF部分型号USB供电策略可能干扰containerd依赖加载 |

---

## Ubuntu 系统 Docker 安装

### 环境准备与基础配置

Ubuntu 安装 Docker 存在两条主流路径：通过 APT 仓库安装（推荐）和使用官方 convenience script（仅推荐测试环境）。生产环境优先选择 APT 仓库方式，以保障版本可控性与后续升级管理。

首先更新系统软件包索引，确保所有依赖处于最新状态：

```bash
sudo apt update && sudo apt upgrade -y
```

华硕 TUF NAS 部分型号默认关闭 cgroup 内存限制，Docker 运行时需要内核支持 cgroups v2。检查当前 cgroup 版本：

```bash
stat -fc %T /sys/fs/cgroup/
```

输出结果为 `cgroup2fs` 表示已启用 cgroups v2，符合现代 Docker 要求。若为 `tmpfs` 或传统 cgroup v1，需在内核启动参数中追加 `systemd.unified_cgroup_hierarchy=1`，该操作需编辑 `/etc/default/grub` 中的 `GRUB_CMDLINE_LINUX_DEFAULT` 字段后执行 `sudo update-grub` 并重启。

### 内核参数调优

在 Ubuntu 上部署 Docker 前，建议预先调整若干内核参数以适配容器运行需求。编辑 `/etc/sysctl.d/99-docker.conf`：

```bash
sudo tee /etc/sysctl.d/99-docker.conf <<EOF
net.ipv4.ip_forward = 1
net.ipv6.conf.all.forwarding = 1

net.bridge.bridge-nf-call-iptables = 1
net.bridge.bridge-nf-call-ip6tables = 1

fs.file-max = 2097152

vm.max_map_count = 262144
EOF
```

应用配置：

```bash
sudo sysctl --system
```

### 安装依赖包

Docker 依赖若干系统工具，需提前安装：

```bash
sudo apt install -y ca-certificates curl gnupg lsb-release
```

其中 `gnupg` 用于验证软件包签名，`lsb-release` 提供发行版信息，`curl` 用于下载公钥。

### 添加 Docker 官方 GPG 密钥与 APT 仓库

创建 `/etc/apt/keyrings` 目录（Ubuntu 22.04 及以后版本要求），并导入 Docker 仓库签名密钥：

```bash
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
```

随后配置 Docker APT 仓库：

```bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

此处 `$(dpkg --print-architecture)` 自动匹配 CPU 架构，涵盖 amd64、arm64 等主流平台，华硕 TUF NAS 使用的 Intel 处理器对应 amd64 架构。

### 安装 Docker Engine

更新软件包索引并执行安装：

```bash
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

---

【标签】
Thinkpad, IBM, X1 Carbon, AI开发, Ollama部署, 本地大语言模型, VSCode配置, 华强北, 选购指南

【相关阅读】
- Thinkpad T14 深度评测：商务本的性能极限在哪里
- OpenClaw多模型集成配置指南
- 华强北Thinkpad港版购买防坑指南