vikings/nedomi

nedomi

基于Golang的HTTP媒体缓存服务器，针对媒体文件特性优化缓存策略，有效提升分发效率与资源利用率。

镜像概述

nedomi是一款专注于媒体文件的缓存代理工具，核心设计理念是避免存储未被用户访问的大文件部分。它通过分段存储和灵活的缓存算法，仅保留热门文件片段，从而在降低磁盘占用的同时提升缓存命中率。

核心功能

• 分段缓存机制：将媒体文件分割为固定大小片段，仅缓存用户实际观看的部分。
• 可扩展算法：支持自定义缓存算法（当前默认实现分段LRU）。
• 多虚拟主机：允许配置多个虚拟主机，共享或独立使用缓存区。
• 状态监控：提供HTTP状态页面，展示服务器性能与内部状态。
• 模块化架构：支持扩展缓存算法、存储方式等核心组件。

使用场景

• 视频流加速：为视频网站、直播平台提供缓存支持，减少源站带宽压力。
• 媒体分发优化：针对大型音频/视频文件，提升分发效率。
• 内容加速服务：为需要频繁访问媒体资源的应用提供本地缓存。

配置说明

nedomi使用JSON文件配置，核心模块包括系统设置、缓存区、HTTP服务及虚拟主机。

关键配置示例

1. HTTP服务配置：

json
"http": {
  "listen": ":8282",
  "max_headers_size": 1048576,
  "virtual_hosts": [/* 虚拟主机列表 */]
}

2. 缓存区配置：

json
"cache_zones": [
  {
    "id": 1,
    "path": "/cache",
    "storage_objects": 10000,
    "part_size": "4m",
    "cache_algorithm": "lru"
  }
]

3. 虚拟主机配置：

json
"virtual_hosts": [
  {
    "name": "media.example.com",
    "upstream": "http://origin.example.com",
    "cache_zone": 1
  }
]

### Docker部署示例
#### 单容器运行
```bash
# 准备config.json（参考官方示例）
docker run -d \
  -p 8282:8282 \
  -v ./config.json:/app/config.json \
  -v ./cache_dir:/cache \
  vikings/nedomi --config /app/config.json

Docker Compose示例

yaml
version: "3"
services:
  nedomi:
    image: vikings/nedomi
    ports:
      - "8282:8282"
    volumes:
      - ./config.json:/app/config.json
      - ./cache:/cache
    command: --config /app/config.json