# LinuxServer.io

## Type
- Entity
- Organization / Open Source Project

## Description
LinuxServer.io 是一个社区驱动的开源组织，专门为流行的自托管应用维护高质量的 Docker 镜像。所有镜像均遵循标准化配置模式，支持 PUID/PGID 环境变量、统一的目录结构、Web UI 默认端口约定，以及完整的文档支持。

## Key Facts
- **Focus**: Self-hosted applications on Docker
- **Image Registry**: lscr.io (Docker Hub official partner)
- **Standard Variables**: PUID, PGID, TZ, UMASK_SET
- **Notable Images**: transmission, jellyfin, navidrome, plex, sonarr, radarr, jackett, SABnzbd, home-assistant, nginx, nextcloud, portainer, it-tools, etc.
- **License**: Various (per image)

## Standard Configuration Pattern

所有 LinuxServer.io 镜像遵循统一配置规范：

### Environment Variables
```yaml
environment:
  - PUID=1000        # Process UID (宿主用户ID)
  - PGID=1000        # Process GID (宿主组ID)
  - TZ=Etc/UTC       # Timezone
  # Image-specific variables below
```

### Volume Mounts
```yaml
volumes:
  - /path/to/config:/config    # 配置目录
  - /path/to/downloads:/downloads  # 可选：下载目录
```

### Restart Policy
```yaml
restart: unless-stopped  # 容器异常退出后自动重启
```

### Network Mode
```yaml
network_mode: bridge     # 桥接网络，支持端口映射
```

## Notable Images in shenwei's Home Server

| Image | Purpose | Port |
|-------|---------|------|
| [[Transmission]] | BT 下载客户端 | 9091 |
| [[Jellyfin]] | 视频流媒体服务器 | 8096 |
| [[Navidrome]] | 音乐流媒体服务器 | 4533 |
| portainer | Docker 容器管理 | 9000 |
| it-tools | IT 工具集 | 8080 |
| home-assistant | 智能家居控制 | 8123 |

## Connections
- [[Transmission]] — maintained image
- [[Jellyfin]] — maintained image
- [[Navidrome]] — maintained image
- [[Docker]] — deployment platform
- [[群晖 NAS]] — 常见部署平台
- [[Docker Compose]] — recommended deployment method