本文整理了基于 Docker Compose 的常用管理命令、1Panel 环境下的应用路径以及一些进阶运维小技巧。

🌀 一、容器基础管理

如果你使用 Docker Compose 管理项目（推荐方式），以下命令是你的“家常便饭”。

1. 重启容器 vs 重建容器

很多新手分不清 restart 和 up -d 的区别，这里划重点：

🔁 二、镜像更新全流程

当远程镜像发布新版本（如 MoviePilot 或 Jellyfin 更新）时，建议遵循以下标准步骤，既能保证更新，又能节省空间：

1. 拉取最新镜像：docker compose pull
2. 应用并重启：docker compose up -d
3. 清理冗余数据：
   更新后，旧镜像会变成虚悬镜像（显示为 <none>），长期不清理会吃掉几十 GB 的磁盘。

   1	docker image prune -f

🛠️ 三、单个容器的精准操控

如果你只想操作某个特定应用（如 nezha-dashboard），而不想影响同目录下的其他服务，请直接调用 Docker 原生命令：

• 停止：docker stop <容器名>
• 启动：docker start <容器名>
• 查看实时日志：docker logs -f --tail 100 <容器名>
• 进入容器内部：docker exec -it <容器名> sh (或 bash)

📂 四、常用本地应用路径 (1Panel 环境)

在 1Panel 面板管理的服务器中，应用数据通常存放于以下路径。手动修改配置或迁移数据时，直接定位到这些目录即可：

• 🎥 媒体类:
  • /opt/1panel/apps/local/moviepilot/moviepilot
  • /opt/1panel/apps/jellyfin/jellyfin
  • /opt/1panel/apps/local/emby-amilys/emby-amilys
• ⚙️ 自动化类:
  • /opt/1panel/apps/local/vertex/localvertex
  • /opt/1panel/apps/local/autobangumi/autobangumi

⚠️ 运维小技巧与避坑指南

1. 打造清晰的监控视图

默认的 docker ps 信息太乱？试试这个精简格式：

1

docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

2. 容器“无限重启”排查

如果容器状态显示 Restarting 或 Exited (1)，不要盲目重启，先看报错：

1

docker logs --tail 50 <容器名>

通常是由于配置文件路径挂载错误或端口冲突导致。

3. 让更新自动化：Watchtower

如果你懒得手动执行 pull 操作，可以部署 Watchtower。它会每隔 24 小时自动检查并更新所有容器：

1

docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup --interval 86400

🎉 总结

熟练掌握 Docker Compose 的生命周期管理，不仅能让你的 HomeLab 运行得更稳，也能在服务出现异常时快速定位问题。

建议： 即使使用了 1Panel 等面板，也建议多尝试 SSH 命令行操作。图形化界面虽然方便，但命令行能让你在网络环境极差、面板打不开的极端情况下依然拥有对服务器的绝对掌控权。

本文将带你走完查看、分区、格式化、挂载、持久化的完整磁盘配置流程。

🛠️ 磁盘配置工作流

1️⃣ 探视：确认新硬盘身份

在动刀之前，先确认新硬盘的设备名称。

1

lsblk

• vda/sda：通常是系统盘（System Disk）。
• vdb/sdb：通常是新加的数据盘（Data Disk）。如果它的 MOUNTPOINT 为空，说明它还没被派上用场。

2️⃣ 操刀：创建磁盘分区

对于全新的磁盘，我们需要通过分区表告诉系统如何利用这段空间。

1

sudo fdisk /dev/vdb

交互命令说明：

1. 输入 n：新建分区（New）。
2. 输入 p：选择主分区（Primary）。
3. 回车 x2：起始和结束扇区均选择默认值，即分配全部空间。
4. 输入 w：将修改写入磁盘（Write）并退出。

3️⃣ 洗礼：格式化文件系统

分区完成后，系统会出现 /dev/vdb1。我们需要把它格式化为 Linux 最常用的 ext4（或高性能的 xfs）格式。

1

sudo mkfs.ext4 /dev/vdb1

⚠️ 高能预警：此操作会擦除该分区所有数据！请务必确认操作的是正确的分区。

4️⃣ 定居：创建挂载点并挂载

在 Linux 中，硬盘必须挂载到一个具体的目录（文件夹）才能访问。

1
2
3
4
5

# 1. 创建挂载目标目录
sudo mkdir /data

# 2. 临时执行挂载
sudo mount /dev/vdb1 /data

5️⃣ 恒久：配置开机自动挂载

如果仅执行上面的 mount，机器重启后硬盘会再次消失。我们需要修改 /etc/fstab。

🚀 进阶推荐：使用 UUID 挂载

设备名（如 /dev/vdb1）在多次插拔硬盘后可能会变，但 UUID 是唯一的。

1. 获取 UUID：

   1 2	sudo blkid /dev/vdb1 # 输出：/dev/vdb1: UUID="xxxx-xxxx-xxxx" TYPE="ext4" ...

2. 编辑系统配置：

   1	sudo nano /etc/fstab

3. 添加配置行：
   在末尾添加（用你查到的实际 UUID 替换）：

   1	UUID=你的UUID /data ext4 defaults,nofail 0 2

   nofail：如果硬盘意外损坏或丢失，系统仍能正常启动，不会卡在开机自检界面。

6️⃣ 验核：确保配置无误

修改完 fstab 后，千万不要直接重启！ 先进行测试：

1
2
3

sudo umount /data    # 先卸载
sudo mount -a         # 模拟开机自动挂载所有设备
df -h                 # 查看结果

如果 df -h 重新看到了 /data，说明配置完美。

💡 运维小贴士

1. 分流存储：挂载成功后，记得修改 Docker 的 data-root 路径或 MySQL 的存储目录到 /data，让系统盘保持清爽。
2. 扩容注意：如果是云服务商提供的“在线扩容”，分区和挂载步骤会有所不同，通常需要使用 resize2fs 来调整文件系统大小。
3. 定期巡检：定期通过 smartctl（如果支持）检查硬盘健康度，数据安全大于一切。

🎉 总结

挂载硬盘是 Linux 运维的必经之路。掌握了 UUID 挂载法，你就已经超越了 80% 的新手，避开了系统因磁盘变动而无法启动的深坑。

你会选择将哪些服务迁移到新硬盘上？欢迎分享你的分区的方案！

本文将介绍如何通过 Git 安全地同步 Stellar 主题，并解决更新过程中可能遇到的常见问题。

🛠️ 更新前的核心逻辑

在 Hexo 中，主题通常作为 Git 的一个子模块或独立仓库存在。更新的核心分为三步：拉取代码 -> 同步依赖 -> 重构缓存。

1️⃣ 进入主题核心目录

首先，你需要定位到 Stellar 主题的根目录。

• Windows:

  1	cd F:\Hexo-Blog\blog-demo\themes\stellar

• Linux/macOS:

  1	cd ~/Hexo-Blog/blog-demo/themes/stellar

2️⃣ 同步远程仓库代码

执行 Git 拉取命令。如果你的主题是通过 git clone 下载的，直接运行：

1

git pull origin main

💡 进阶：如果报错提示“Local changes”？

如果你修改了主题内部的代码（如 layout 或 scripts），更新会报错。建议使用 Stash（暂存） 机制：

1. git stash (暂存本地修改)
2. git pull (拉取更新)
3. git stash pop (合并回修改)

3️⃣ 重新维护环境依赖

Stellar 主题的许多高级渲染功能（如流程图、渲染插件）依赖于特定的 npm 包。更新代码后，务必同步主题目录下的依赖：

1
2

# 在 themes/stellar 目录下执行
npm install

4️⃣ 全局清理与预览

回到博客根目录，进行“大扫除”并重新构建。

1
2

cd ../../
hexo clean && hexo g && hexo s

• hexo clean: 必须执行，否则旧主题的缓存会导致页面排版错乱。
• hexo g: 重新生成静态文件。
• hexo s: 本地预览，重点检查新功能是否生效，以及控制台是否有报错。

⚠️ 避坑指南：给 Stellar 用户的 3 个建议

1. 优先使用 _config.stellar.yml

强烈建议：不要直接修改主题目录下的 _config.yml。
在博客根目录下创建一个 _config.stellar.yml 文件。Hexo 会自动合并配置。这样你在更新主题时，你的个性化配置永远不会被覆盖。

2. 检查插件版本

Stellar 有时会要求配合特定版本的 hexo-renderer-styled 或其他插件。更新后如果渲染异常，请查看主题 GitHub 仓库的 package.json 确认版本要求。

3. 备份是第一生产力

在执行 git pull 前，习惯性地将 themes/stellar 整个目录压缩备份一份，哪怕操作失误也能秒回滚。

🎉 总结

更新 Stellar 主题并不复杂，关键在于依赖同步和缓存清理。建议每个月检查一次更新，让你的博客始终保持最佳性能和最新的交互体验。