Docker 部署 fndesk 桌面图标管理工具 🐳

📋 目录导航

🎯 项目简介
🛠️ 核心特性
🐳 一、Docker 部署 fndesk
- 1. 创建部署目录和 docker-compose.yml 文件 📁
- 2. 拉取镜像并启动容器 🚀
🚀 二、使用 fndesk
- 1. 访问 Web 界面 🌐
- 2. 功能特性介绍 🔍
🌐 三、Nginx 反向代理配置
- 1. 创建 Nginx 配置文件 🔧
- 2. 测试并重载 Nginx 🔄
🔧 四、容器维护命令
🌟 功能强大的桌面应用中心

🎯 项目简介

fndesk 是一个功能强大的桌面应用中心，基于现代化的 Web 技术栈开发，提供丰富的应用管理和图标资源功能。该项目集成了高清图标库、应用管理、个性化设置等特性，为用户提供统一的应用访问入口和美观的界面体验。

🐱 GitHub 项目地址： https://github.com/IMGZCQ/fndesk
📦 Docker 镜像：imgzcq/fndesk:latest
🔧 技术栈：基于现代化的 Web 框架开发，支持容器化部署
🎯 主要功能：应用管理、图标资源、个性化桌面、多媒体支持

🛠️ 核心特性

特性类别	功能描述
🎨 界面美观	现代化的 UI 设计，响应式布局，支持主题定制
📱 应用管理	统一的应用中心，支持应用分类、搜索和快捷启动
🖼️ 图标资源	内置高清图标库，支持多种图标格式和风格
🔧 个性化设置	丰富的个性化选项，支持布局、主题、壁纸等自定义
🌐 多端适配	支持桌面端、移动端访问，跨平台兼容
📺 多媒体支持	集成影视个性化功能，支持多媒体内容管理
⚡ 高性能	优化的加载速度，流畅的用户体验
🔒 安全可靠	安全的容器化部署，数据持久化保障

🐳 一、Docker 部署 fndesk

1. 创建部署目录和 `docker-compose.yml` 文件 📁

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27


# 创建部署目录并进入
mkdir -p /vol1/1000/compose/fndesk && cd $_

# 创建 docker-compose.yml 文件
cat > docker-compose.yml <<'EOF'
services:
  fndesk:                    # Compose项目名称
    container_name: fndesk        # docker容器名称
    image: imgzcq/fndesk:latest    # 镜像名称
    ports:
     - 9990:9990              # HTTP端口
     - 9991:9991              # HTTPS端口 
    volumes:
     - /usr/trim/www:/fnw        # Web文件目录（重要：不能修改）
     - /usr/trim/share/.restore:/res # 恢复数据目录（重要：不能修改）
     - /usr/local/apps/@appcenter/trim.media:/trim.media  # 影视个性化目录
     - ./deskdata:/deskdata       # 桌面数据目录（可自定义左边路径）
    environment:
     - TZ=Asia/Shanghai          # 时区设置
    restart: always             # 容器自动重启
    networks:
     - fndesk-network

networks:
  fndesk-network:
    driver: bridge
EOF

📝 配置说明：

镜像版本：使用官方最新版镜像 imgzcq/fndesk:latest
容器名称：命名为 fndesk，便于识别和管理
端口映射：HTTP(9990) 和 HTTPS(9991) 双端口支持
数据持久化：多个关键目录挂载确保数据安全
- /fnw：Web 应用文件目录（核心目录，不可更改）
- /res：系统恢复数据目录（重要数据，不可更改）
- /trim.media：影视个性化数据目录（v0.73+ 版本必需）
- /deskdata：用户桌面数据目录（可自定义宿主机路径）

2. 拉取镜像并启动容器 🚀

1
2
3
4
5
6
7
8


# 拉取最新镜像并启动服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看启动日志
docker-compose logs -f

✅ 验证部署：

1
2
3
4
5
6
7
8


# 检查容器运行状态
docker ps | grep fndesk

# 测试服务可达性
curl http://localhost:9990

# 检查容器健康状态
docker inspect fndesk | grep Status

🚀 二、使用 fndesk

1. 访问 Web 界面 🌐

部署完成后，通过以下方式访问 fndesk 桌面应用中心：

🌍 本地访问：http://localhost:9990
🔐 HTTPS 访问：https://localhost:9991
🔗 局域网访问：http://服务器IP:9990
🌐 域名访问：https://fndesk.yourdomain.com（配置反向代理后）

🖥️ 界面功能区域：

顶部导航栏：应用搜索、用户设置、系统通知
侧边应用栏：应用分类、快捷方式、系统工具
主桌面区：应用图标网格、小部件、个性化内容
底部状态栏：系统状态、快捷操作、多媒体控制

2. 功能特性介绍 🔍

功能模块	详细描述	使用场景
📱 应用中心	统一的应用管理界面，支持应用分类、搜索、安装	快速查找和启动应用程序
🎨 个性化设置	主题切换、壁纸设置、布局调整	定制个性化桌面环境
🖼️ 图标管理	高清图标库，支持图标预览、下载、替换	美化应用图标和界面元素
📺 影视中心	多媒体内容管理，影视资源个性化推荐	娱乐和媒体消费
🔧 系统工具	系统状态监控、文件管理、设置配置	系统维护和管理
📊 小部件	天气、日历、系统监控等桌面小部件	实时信息展示

💡 使用技巧：

使用搜索功能快速定位应用和功能
合理分类应用，提高使用效率
定期备份桌面配置和数据
利用个性化设置打造专属工作环境

🌐 三、Nginx 反向代理配置

访问地址示例： https://fndesk.yourdomain.com

1. 创建 Nginx 配置文件 🔧

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83


# 创建 Nginx 配置文件
cat > /etc/nginx/conf.d/fndesk.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;

    server_name fndesk.yourdomain.com;  # 🌐 请替换为您的实际域名

    # SSL 证书配置
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
    
    # TLS 安全配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;

    # 安全响应头
    add_header Strict-Transport-Security "max-age=31536000" always;
    add_header X-Content-Type-Options nosniff always;
    add_header X-Frame-Options SAMEORIGIN always;
    add_header X-XSS-Protection "1; mode=block";

    # 反向代理配置
    location / {
        proxy_pass http://localhost:9990;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 超时设置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
        
        # 缓冲区设置
        proxy_buffering on;
        proxy_buffer_size 4k;
        proxy_buffers 8 4k;
        
        # 禁用缓存，确保实时内容更新
        proxy_no_cache 1;
        proxy_cache_bypass 1;
    }

    # 静态资源缓存优化
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        proxy_pass http://localhost:9990;
        expires 1y;
        add_header Cache-Control "public, immutable";
        add_header Vary "Accept-Encoding";
    }

    # API 接口不缓存
    location ~* /api/ {
        proxy_pass http://localhost:9990;
        proxy_no_cache 1;
        proxy_cache_bypass 1;
        add_header Cache-Control "no-cache, no-store, must-revalidate";
    }

    # 错误页面
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
        internal;
    }
}

# HTTP 重定向到 HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name fndesk.yourdomain.com;
    return 301 https://$server_name$request_uri;
}
EOF

2. 测试并重载 Nginx 🔄

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 测试配置文件语法
sudo nginx -t

# 重载 Nginx 配置
sudo systemctl reload nginx

# 查看 Nginx 状态
sudo systemctl status nginx

# 检查防火墙设置（如启用）
sudo ufw status
sudo ufw allow 80
sudo ufw allow 443

🔧 配置要点：

替换 server_name 为你的实际域名
确保证书路径正确（推荐使用 Let’s Encrypt）
根据实际网络环境调整超时时间
静态资源缓存提升访问性能
API 接口禁用缓存确保数据实时性

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


# 进入项目目录
cd /vol1/1000/compose/fndesk

# 📊 查看服务状态
docker-compose ps

# ⏸️ 停止服务
docker-compose down

# 🔄 拉取最新镜像
docker-compose pull

# 🚀 启动服务
docker-compose up -d

# 📝 查看服务日志
docker-compose logs

# 🔍 实时跟踪日志
docker-compose logs -f

# 🛠️ 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

# 💾 备份重要数据
tar -czf fndesk-backup-$(date +%Y%m%d).tar.gz ./deskdata
cp docker-compose.yml docker-compose.backup.yml

2. Docker 容器命令 📦

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36


# 📋 查看所有容器
docker ps -a

# 🏃 查看运行中容器
docker ps

# ⏹️ 停止容器
docker stop fndesk

# ▶️ 启动容器  
docker start fndesk

# 🔄 重启容器
docker restart fndesk

# 🗑️ 删除容器
docker rm fndesk

# 🔨 进入容器Shell
docker exec -it fndesk sh

# 💻 在容器中执行命令
docker exec fndesk ls -la /fnw

# 📊 查看容器资源使用
docker stats fndesk

# 🔍 查看容器详情
docker inspect fndesk

# 📝 容器日志管理
docker logs fndesk                    # 查看日志
docker logs -f fndesk                 # 实时跟踪日志
docker logs --tail 100 fndesk         # 查看最后100行
docker logs -t fndesk                 # 带时间戳的日志
docker logs --since 1h fndesk         # 查看最近1小时日志

3. Docker 镜像管理 📀

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 📷 列出所有镜像
docker images

# 🗑️ 删除指定镜像
docker rmi imgzcq/fndesk:latest

# 🧹 清理悬空镜像
docker image prune -f

# 🗂️ 清理所有未使用镜像
docker image prune -a -f

# 📥 拉取特定版本镜像
docker pull imgzcq/fndesk:1.0.0

# 🏷️ 给镜像打标签
docker tag imgzcq/fndesk:latest myregistry/fndesk:latest

# 📤 推送镜像到私有仓库
docker push myregistry/fndesk:latest

🌟 功能强大的桌面应用中心

通过本文档，你已经成功使用 Docker 部署了 fndesk 桌面应用中心，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🎯 统一管理 集中管理所有应用程序，提供统一访问入口
🎨 个性化定制 根据喜好定制桌面主题、布局和外观
🖼️ 丰富资源 访问内置的高清图标库和应用资源
📺 多媒体体验 享受影视个性化功能和多媒体内容
⚡ 高效访问 基于容器化架构，快速响应的用户体验
🔒 安全可靠 通过 HTTPS 加密访问，数据持久化保障

fndesk 为你提供了全方位的桌面应用管理体验，无论是：

🏠 个人使用：打造个性化的家庭桌面环境
💼 办公场景：统一的工作应用入口和管理
🎮 娱乐中心：多媒体内容和应用的集中管理
🔧 开发环境：开发工具和应用的快捷访问
📊 信息展示：桌面小部件和实时信息监控

🚀 开始使用建议：

初次配置：访问系统设置，完成基础配置
应用整理：合理分类应用，提高使用效率
个性化设置：根据喜好调整主题和布局
数据备份：定期备份桌面配置和重要数据
版本更新：关注项目更新，及时获取新功能

从现在开始，让 fndesk 成为你的数字生活控制中心，提升工作效率，享受个性化的桌面体验！🎉

📌 持续关注：建议关注 fndesk 官方更新，及时获取新功能和优化。
🐛 问题反馈：使用中遇到问题或有建议，可前往 GitHub Issues 提出。
🤝 社区贡献：欢迎提交 Pull Request，共同完善这个优秀的桌面应用中心项目。

祝你使用愉快，桌面管理得心应手！🎉