易有云(LinkEase) Docker镜像文档

镜像概述和主要用途

易有云(LinkEase)是一款面向个人和家庭用户的私有网盘解决方案，通过Docker容器化部署，提供简单易用的文件管理体验。其核心优势在于优化的点对点网络传输，支持远程文件管理、跨设备同步、相册备份及异地组网访问局域网资源，帮助用户构建安全高效的私有存储系统。

核心功能和特性

点对点传输优化：优先采用P2P网络传输，减少中间环节，提升数据传输效率
网络配置灵活：支持Host模式和Custom br0模式，避免额外NAT层级，确保局域网通信性能
多功能文件管理：集成远程文件管理、多设备同步、相册自动备份等基础网盘功能
局域网资源访问：支持通过易有云远程访问局域网内的Samba共享路径等资源
容器化部署：轻量级Docker镜像，配置简单，支持数据和配置持久化存储

使用场景和适用范围

个人/家庭私有网盘搭建，实现文件集中管理与共享
跨设备、跨网络（异地）文件访问与同步需求
家庭相册自动备份与多设备查看
异地组网场景，需远程访问局域网内共享资源（如Samba服务器）

网络配置建议

为确保功能完整性和网络性能，避免因额外NAT层级影响局域网通信（如网速、网络发现、远程Samba访问），推荐以下网络配置：

Host模式：直接使用主机网络，通过--network host参数指定，减少NAT隔离
Custom br0模式：将Docker网络桥接到局域网，使容器获取与主机同网段IP，避免NAT中转

使用方法和配置说明

基础部署命令（推荐）

以下命令采用Host网络模式，固定版本1.2.4，配置简单且网络优化：

docker
docker run -d \
    --network host \
    --name linkease \
    --restart unless-stopped \
    -v /root/linkease-data:/linkease-data \
    -v /root/linkease-config:/linkease-config \
    -v /etc/localtime:/etc/localtime:ro \
    -e PUID=0 \
    -e PGID=0 \
    linkease/linkease:1.2.4

详细配置命令（自定义参数）

如需自定义端口、容器名称或使用最新版本，可参考以下命令：

docker
docker run -d \
    --cap-add=NET_ADMIN \  # 可选，添加网络管理权限
    -p 8897:8897 \         # 端口映射（非Host模式时需指定）
    --name=<container name> \  # 自定义容器名称
    -v <path for data files>:/linkease-data \  # 数据文件持久化路径
    -v <path for config files>:/linkease-config \  # 配置文件持久化路径
    -v /etc/localtime:/etc/localtime:ro \  # 同步主机时区
    -e PUID=<uid for user> \  # 可选，运行用户ID（如0为root）
    -e PGID=<gid for user> \  # 可选，运行用户组ID
    linkease/linkease:<ver>  # 指定版本（latest为最新版）

参数说明

参数	说明	必要性
`--network host`	使用主机网络，避免NAT隔离	推荐
`--restart unless-stopped`	容器退出时自动重启（手动停止除外）	推荐
`-v /linkease-data`	挂载数据文件目录，实现数据持久化	必需
`-v /linkease-config`	挂载配置文件目录，保存用户配置	必需
`-v /etc/localtime:ro`	同步主机时区，确保时间一致性	推荐
`-e PUID/PGID`	指定运行用户ID和组ID，默认可省略	可选
`--cap-add=NET_ADMIN`	添加网络管理权限，增强网络功能	可选
`-p 8897:8897`	端口映射，非Host模式下需指定容器端口	按需配置