Skip to content

Latest commit

 

History

History
133 lines (98 loc) · 2.91 KB

README.md

File metadata and controls

133 lines (98 loc) · 2.91 KB
Raw

高清图片转ICO工具 (Docker版)

一个简单易用的图片转ICO转换工具，支持单个文件转换和批量转换，可生成多种尺寸的图标文件。本项目已适配 Docker 部署，提供更便捷的安装和使用方式。

功能特性

  • 🖼️ 支持常见图片格式转换（PNG, JPG, JPEG, BMP, GIF）
  • 🎯 可选择多种输出尺寸（16x16 到 512x512）
  • 📦 支持单个文件转换和批量转换
  • 💾 自定义输出目录
  • 🔍 高质量转换，使用 LANCZOS 算法
  • 🌐 基于Web界面，使用方便
  • ✨ 支持生成多尺寸ICO文件
  • 🐳 支持 Docker 部署，跨平台兼容

系统要求

  • Docker Desktop (Windows/MacOS) 或 Docker Engine (Linux)
  • 2GB 以上可用内存
  • 1GB 以上可用磁盘空间

快速开始

  1. 克隆项目到本地：
git clone https://github.com/yourusername/image-to-ico.git
cd image-to-ico
  1. 使用 docker-compose 启动服务：
docker-compose up -d
  1. 访问Web界面：

就是这么简单！🎉

使用说明

单个文件转换

  1. 打开Web界面 (http://localhost:7860)
  2. 选择"单个文件转换"标签页
  3. 点击"上传图片"选择要转换的图片文件
  4. 选择需要的图标尺寸（可多选）
  5. 可选：指定输出目录
  6. 点击"转换"按钮
  7. 转换完成后可直接下载或到输出目录查看文件

批量转换

  1. 打开Web界面 (http://localhost:7860)
  2. 选择"批量转换"标签页
  3. 在输入框中填写包含图片的文件夹路径
  4. 选择需要的图标尺寸（可多选）
  5. 可选：指定输出目录
  6. 点击"开始批量转换"按钮
  7. 等待转换完成，查看输出目录中的转换结果

支持的格式

输入格式

  • PNG
  • JPG/JPEG
  • BMP
  • GIF

输出格式

  • ICO（Windows图标文件）

容器管理

常用命令

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 查看日志
docker-compose logs -f

# 重启服务
docker-compose restart

# 重建镜像
docker-compose build --no-cache

自定义端口

如需修改默认端口(7860)，请编辑 docker-compose.yml 文件：

ports:
  - "新端口:7860"

注意事项

  1. 文件权限

    • 确保 output 目录具有适当的读写权限
    • Docker 运行时会自动创建必要的目录

  2. 性能优化

    • 建议上传方形图片以获得最佳效果
    • 批量转换时，建议图片数量不超过100张

  3. 安全建议

    • 建议在内网环境使用
    • 如需外网访问，请配置适当的安全措施

  4. 常见问题

    • 如果网页无法访问，请检查防火墙设置
    • 如果转换失败，请检查图片格式和尺寸是否符合要求

更新维护

更新步骤

  1. 拉取最新代码：
git pull
  1. 重新构建并启动：
docker-compose up -d --build

许可证

MIT License - 详见 LICENSE 文件