screenly/srly-ose-nginx

Screenly OSE - 树莓派开源数字标牌解决方案

概述与主要用途

Screenly OSE（开源版）是专为树莓派设计的数字标牌解决方案，用于构建低成本、易部署的数字 signage 系统。需注意，Screenly OSE 与商业版（原 Screenly Pro）为完全独立产品，无共享代码，管理方式和性能差异显著，不可相互替代评估。该方案支持所有树莓派型号，包括 Pi Zero、Pi 3 Model B+ 及 Pi 4 Model B 等。

核心功能与特性

• 开源免费：基于开源协议，适合个人及企业低成本项目
• 多安装方式：支持磁盘镜像（推荐）、Raspbian 脚本安装及 Balena 云部署
• 广泛硬件支持：兼容从 Pi Zero 到 Pi 4 的所有树莓派型号
• 开发友好：提供 Docker 化开发环境及单元测试支持

使用场景与适用范围

适用于各类数字信息展示场景，如零售店广告屏、办公公告板、学校信息屏、餐厅菜单板等，尤其适合需要低成本、树莓派硬件环境的小型 signage 部署。

详细使用方法与配置说明

磁盘镜像安装（推荐）

1. 从 https://github.com/Screenly/screenly-ose/releases 获取最新磁盘镜像
2. 使用工具（如 Etcher）将镜像写入 SD 卡
3. 插入树莓派启动即可完成部署

在 Raspbian/Raspberry Pi OS 上安装

适用于已安装 Raspbian Lite 系统的环境，执行以下命令：

bash
bash <(curl -sL https://www.screenly.io/install-ose.sh)

安装时间说明：15分钟至数小时不等，受以下因素影响：

• 树莓派硬件版本（Pi 3 B+ 最快，Pi Zero 最慢）
• SD 卡速度（Class 10 优于 Class 4）
• 网络连接速度
  理想条件下（Pi 3 B+、Class 10 SD 卡、高速网络）需 15-30 分钟，低端设备可能耗时数小时，建议优先选择磁盘镜像安装。

通过 Balena 部署

1. 点击 Balena 部署按钮（仅支持 Pi 3）：
   
2. 其他型号树莓派部署方法参考 https://github.com/Screenly/screenly-ose/blob/master/docs/balena.md

系统升级

Screenly OSE 按 https://github.com/Screenly/screenly-ose/projects 发布更新，每个周期结束后将开发分支（master）合并至生产分支并生成新磁盘镜像。
升级至最新开发版方法：重新运行安装脚本并选择"开发版"，通常耗时几分钟（取决于变更量）。

Docker 化开发环境

用于简化服务器模块开发，需先克隆源码仓库，在仓库目录中执行：

bash
docker-compose -f docker-compose.dev.yml up

运行单元测试

bash
nosetests --with-doctest

相关资源

• 版本选择指南
• 常见问题
• 官方论坛
• 在线演示
• API 文档
• https://github.com/Screenly/screenly-ose/blob/master/docs/developer-documentation.md