树莓派5变身家庭服务器：用1Panel面板一键搞定Docker、MySQL和代码仓库
树莓派5家庭服务器实战：1Panel面板打造全能开发环境
树莓派5凭借其强大的性能和低功耗特性，成为搭建家庭服务器的理想选择。而1Panel作为一款现代化的开源运维面板，能够大幅简化服务器管理流程，让非专业用户也能轻松部署各类服务。本文将带你从零开始，将树莓派5打造成一个集Docker容器、MySQL数据库和私有代码仓库于一体的全能家庭服务器。
1. 准备工作与1Panel安装
在开始之前，确保你已准备好以下物品：
- 树莓派5主板（建议8GB内存版本）
- 至少32GB的microSD卡或SSD存储
- 稳定的电源适配器
- 有线网络连接（推荐千兆环境）
系统准备是第一步。建议使用官方64位Raspberry Pi OS Lite版本，既节省资源又稳定可靠。安装完成后，执行常规的系统和软件包更新：
sudo apt update && sudo apt upgrade -y接下来安装1Panel面板。这个国产运维工具以其简洁的界面和强大的功能著称，特别适合家庭和小型办公环境：
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh安装过程中会提示设置面板端口（默认是80）和管理员密码。完成后，在局域网内的任何设备浏览器中输入http://树莓派IP地址即可访问1Panel的Web界面。
提示：如果无法访问，请检查树莓派的防火墙设置，确保对应端口已开放。
2. Docker环境配置与优化
1Panel内置了Docker管理功能，但为了获得更好的体验，我们需要进行一些优化配置。
镜像加速是首要任务。国内直接拉取Docker官方镜像速度较慢，我们可以添加国内镜像源：
| 镜像源名称 | 地址 |
|---|---|
| 腾讯云 | https://mirror.ccs.tencentyun.com |
| 中科大 | https://docker.mirrors.ustc.edu.cn |
| 七牛云 | https://reg-mirror.qiniu.com |
在1Panel界面中配置这些镜像源：
- 进入"容器"→"基本配置"
- 在"镜像加速"部分添加上述地址
- 保存设置并重启Docker服务
资源限制也很重要。虽然树莓派5性能提升明显，但合理分配资源能避免服务间相互影响：
# 限制Docker总内存使用为6GB（8GB内存机型） sudo nano /etc/docker/daemon.json添加以下内容：
{ "default-runtime": "runc", "runtimes": { "runc": { "path": "runc" } }, "exec-opts": ["native.cgroupdriver=systemd"], "log-driver": "json-file", "log-opts": { "max-size": "100m" }, "storage-driver": "overlay2", "storage-opts": [ "overlay2.override_kernel_check=true" ], "oom-score-adjust": -500, "memory": "6g" }保存后执行sudo systemctl restart docker使配置生效。
3. MySQL数据库部署与管理
在1Panel的应用商店中，MySQL的安装变得异常简单：
- 打开"应用商店"，搜索MySQL
- 选择最新稳定版本（推荐8.0+）
- 在安装配置页面，设置root密码并勾选"允许外部访问"
- 点击安装，等待完成
性能优化对于树莓派上的MySQL尤为重要。安装完成后，建议调整以下参数：
-- 登录MySQL后执行 SET GLOBAL innodb_buffer_pool_size = 1G; SET GLOBAL innodb_flush_log_at_trx_commit = 2; SET GLOBAL sync_binlog = 0; SET GLOBAL max_connections = 50;这些调整将：
- 分配1GB内存作为缓冲池
- 适当降低数据安全级别换取性能
- 减少二进制日志同步开销
- 限制最大连接数避免资源耗尽
可视化管理方面，phpMyAdmin是最佳选择。在1Panel应用商店中安装后，配置连接信息时需要注意：
- 主机地址填写树莓派的局域网IP
- 端口保持默认3306
- 使用安装时设置的root密码登录
注意：家庭环境中使用MySQL，建议定期备份重要数据。1Panel提供了方便的备份功能，可以设置自动备份计划。
4. 自建代码仓库Gitea实战
Gitea是一个轻量级的代码托管解决方案，非常适合个人和家庭使用。通过1Panel部署Gitea只需几个简单步骤：
- 在应用商店搜索并安装Gitea
- 配置数据库连接（使用之前安装的MySQL）
- 设置管理员账号和仓库根目录
- 完成安装并访问Web界面
Gitea的日常使用技巧：
- SSH访问：在用户设置中添加SSH公钥，实现免密代码推送
- Web钩子：配置GitHub等平台的Webhook，实现代码自动同步
- CI/CD：利用Gitea Actions实现简单的自动化构建和部署
性能优化建议：
# 调整Gitea的SQLite缓存大小（如果使用SQLite） sudo nano /etc/gitea/app.ini添加或修改以下内容：
[database] LOG_SQL = false MAX_IDLE_CONNS = 2 CONN_MAX_LIFETIME = 18005. 进阶应用与系统维护
反向代理是家庭服务器中常用的功能。通过1Panel可以轻松配置Nginx反向代理，实现多服务共用80端口：
- 安装Nginx并创建代理配置
- 为每个服务分配子域名（如git.home、db.home）
- 配置SSL证书实现HTTPS加密
监控与告警能帮助你及时发现问题。1Panel内置了基础监控功能，对于更专业的需求，可以安装Prometheus和Grafana：
# 安装Prometheus docker run -d --name=prometheus -p 9090:9090 -v /path/to/config:/etc/prometheus prom/prometheus # 安装Grafana docker run -d --name=grafana -p 3000:3000 grafana/grafana定期维护包括：
- 系统更新：每月检查一次系统和软件更新
- 备份策略：关键数据至少保留3个备份版本
- 日志清理：设置日志轮转，避免磁盘空间耗尽
6. 家庭服务器实用场景扩展
除了基本的Docker、MySQL和代码仓库，树莓派5家庭服务器还能实现更多实用功能：
家庭NAS解决方案：
- 安装Nextcloud实现私有云存储
- 配置Samba服务实现局域网文件共享
- 设置自动下载工具（如Transmission+qBittorrent）
智能家居中枢：
- 部署Home Assistant整合各类智能设备
- 搭建Node-RED实现自动化流程
- 配置MQTT服务器作为通信桥梁
开发测试环境：
- 搭建Jenkins实现持续集成
- 部署本地DNS服务（如Pi-hole）
- 安装轻量级Kubernetes集群（K3s）
媒体中心：
- 安装Jellyfin或Plex管理家庭影音库
- 配置AirPlay接收器实现无线投屏
- 搭建电子书服务器（如Calibre）
树莓派5的性能提升使得这些服务可以同时运行而不显吃力。通过1Panel的统一管理界面，这些服务的安装、配置和维护都变得简单直观。