手机端OctoPrint极致优化：随时掌控3D打印
让OctoPrint在手机上跑得更顺
OctoPrint 默认已具备响应式布局，但在 5-6 英寸的屏幕上，仍有大量细节可以打磨。下面给出一份针对移动端的完整调优方案，兼顾加载速度与操作手感。
一、配置文件精简
打开 ~/.octoprint/config.yaml，加入或修改以下片段：
gcodeViewer:
mobileSizeThreshold: 1048576 # 1 MB，移动网络更友好
sizeThreshold: 10485760 # 10 MB，桌面端保持不变
feature:
gcodeViewer: true
temperatureGraph: false # 手机端关闭实时曲线，节省流量
二、CSS 微调
在 ~/.octoprint/static/css/mobile-tweak.css 新建文件，写入：
/* 增大按钮点击区域 */
.btn-control {
min-height: 48px;
font-size: 1.1em;
}
/* 隐藏不常用面板 */
@media (max-width: 768px) {
#term, #files .additionalInfo { display: none; }
}
随后在 设置 → 外观 → 自定义样式 中引入该 CSS。
三、控制面板再设计
在 config.yaml 的 controls 节点追加：
controls:
- name: 手机快捷栏
layout: vertical
children:
- name: 预热 PLA
type: parametric_command
command: M104 S{temp}
input:
- name: temp
default: 200
slider: true
min: 180
max: 230
- name: 开始/继续
type: command
command: M24
- name: 暂停
type: command
command: M25
- name: 取消
type: command
command: M0
四、插件取舍清单
| 插件名称 | 移动端建议 |
|---|---|
| DisplayLayerProgress | 保留，文字信息省流量 |
| BedLevelVisualizer | 禁用，3D 网格耗性能 |
| Themeify | 保留，可配合深色主题省电 |
| GcodeEditor | 禁用，手机编辑体验差 |
五、网络与缓存
- 在路由器中为树莓派设置 5 GHz 固定信道，降低延迟。
- 启用 设置 → 功能 → 缓存 G 代码，避免重复下载。
- 每两周执行
sudo journalctl --vacuum-time=7d清理系统日志。
六、快速排障
- 界面卡顿： 检查
mobileSizeThreshold是否过大；关闭温度曲线。 - 按钮误触： 将
.btn-control的min-height提高到 56 px。 - 加载空白： 强制刷新浏览器缓存，或切换至「桌面版网站」再切回。
完成以上步骤后，刷新手机浏览器即可得到一套专为小屏优化的 OctoPrint 控制台：关键信息一目了然，常用操作一步到位。
