atreyu/inkycal.server

Inky-Calendar Server

镜像概述和主要用途

Inky-Calendar Server是一个易配置的基于Web的图像生成器，用于为https://github.com/aceisace/Inky-Calendar%EF%BC%88%E6%88%96%E5%85%B6%E4%BB%96E-Ink%E6%98%BE%E7%A4%BA%E5%B1%8F%EF%BC%89%E6%8F%90%E4%BE%9BE-Ink%E5%85%BC%E5%AE%B9%E9%9D%A2%E6%9D%BF%E3%80%82%E4%BD%9C%E4%B8%BA%E6%9C%8D%E5%8A%A1%E4%BD%BF%E7%94%A8%E5%8F%AF%E8%AE%BF%E9%97%AE%EF%BC%9Ainkycal.robertsirre.nl%EF%BC%88%E5%9F%9F%E5%90%8D%E5%8F%AF%E8%83%BD%E5%8F%98%E6%9B%B4%EF%BC%89%E3%80%82

!Sample panel configuration : a panel with two nested panels

核心功能和特性

• 集中化更新管理：一次配置后无需频繁维护，新功能和 bug 修复可统一应用于所有面板
• 提升面板质量：通过集中化问题反馈优化显示效果
• 加速功能开发：专注于核心功能迭代
• 分担低功耗设备负担：将计算密集型操作从树莓派Zero等低功耗设备转移到服务器，未来可能支持电池供电设备

注意：部分功能仍需在树莓派上更新，例如：板载Web服务器配置（替代SSH）、面板刷新类型管理（可能支持推送更新）

使用场景和适用范围

适合使用InkyCal Server的场景

• 作为InkyCal面板所有者，希望简化配置和维护流程
• 需要集中管理多个E-Ink面板，统一更新和优化
• 希望减轻低功耗设备的运算压力

适合自行部署的场景

1. 开发贡献：开发自定义面板实现或修复bug
2. 数据隐私：不愿将个人信息共享给第三方服务
3. 技术学习：学习.Net Core和Blazor开发

使用方法和配置说明

选项1：使用.Net Core（开发推荐）

克隆仓库后，在根目录执行：

bash
dotnet run --project InkyCal.Server

# 或使用自动重启（代码变更时）：
dotnet watch --project InkyCal.Server run

配置

数据库

部分操作需要SQL Server数据库。可本地安装、通过Docker容器运行或使用网络数据库，然后修改appsettings.json中的连接字符串：ConnectionStrings > DefaultConnection

选项2：使用Docker（快速测试推荐，无数据库）

通过https://hub.docker.com/r/atreyu/inkycal.server%E9%95%9C%E5%83%8F%E5%90%AF%E5%8A%A8Web%E5%BA%94%E7%94%A8%EF%BC%9A

bash
docker run -p 80:80 atreyu/inkycal.server:latest

服务器将在http://localhost可用。如需配置数据库连接：

bash
docker run \
 -e ConnectionStrings__DefaultConnection="Server=MyServerName;Database=MyDataBaseName;User=MyUserName;Password=MyPassword;MultipleActiveResultSets=true" \
 -p 80:80 \
 atreyu/inkycal.server:latest

选项3：使用docker-compose（永久或频繁使用推荐）

创建docker-compose.yml文件，包含Web应用和数据库配置：

yaml
version: '3'
services:
  web:
    image: "atreyu/inkycal.server:latest"
    ports:
      - 5100:5000
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - ASPNETCORE_URLS=http://0.0.0.0:5000/
      - ConnectionStrings__DefaultConnection=Server=db;Database=InkyCal.Server;User=sa;Password=${DB_SA_PASSWORD};MultipleActiveResultSets=true
    depends_on:
      - db
    restart: always
  db:
    image: "mcr.microsoft.com/mssql/server"
    environment:
       SA_PASSWORD: "${DB_SA_PASSWORD}"
       ACCEPT_EULA: "Y"
       MSSQL_PID: "Express"
    # 仅开发时暴露端口
    # ports:
    #  - 1433:1433
    volumes:
      # 持久化存储凭证和面板配置
      - ./sqlserver:/var/opt/mssql/data
    restart: always

创建.env文件存储密钥和变量：

DB_SA_PASSWORD=MySAP@ssw0rd!

启动容器：

bash
docker-compose up -d

服务器将在http://localhost:5100可用。

自行托管时，建议使用Nginx等反向代理配置SSL，避免直接暴露到互联网。