nasbump/ugly-avatar

ugly-avatar Docker镜像文档

镜像概述

ugly-avatar Docker镜像是将开源项目ugly-avatar（源代码：https://github.com/txstc55/ugly-avatar%EF%BC%89%E6%89%93%E5%8C%85%E8%80%8C%E6%88%90%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E7%89%88%E6%9C%AC%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E5%A4%B4%E5%83%8F%E7%94%9F%E6%88%90%E6%9C%8D%E5%8A%A1%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%EF%BC%8C%E7%94%A8%E6%88%B7%E5%8F%AF%E9%80%9A%E8%BF%87%E7%AE%80%E5%8D%95%E5%91%BD%E4%BB%A4%E5%BF%AB%E9%80%9F%E6%90%AD%E5%BB%BA%E5%B9%B6%E4%BD%BF%E7%94%A8%E8%AF%A5%E6%9C%8D%E5%8A%A1%E3%80%82

核心功能与特性

• 基于原ugly-avatar项目功能，提供头像生成服务
• 容器化部署，无需复杂环境配置，简化安装流程
• 支持端口映射，可灵活配置访问端口
• 轻量级部署，资源占用低

使用场景与适用范围

适用于需要快速集成头像生成功能的场景，包括但不限于：

• 个人项目开发与测试
• 小型应用头像功能集成
• 临时头像服务搭建

使用方法与配置说明

Docker Run快速部署

通过以下命令直接启动容器：

bash
docker run -d --name ugly-avatar -p 9080:80 docker.xuanyuan.run/nasbump/ugly-avatar:latest

参数说明：

• -d：后台运行容器
• --name ugly-avatar：指定容器名称为ugly-avatar
• -p 9080:80：将容器内80端口映射到主机9080端口（可根据需要修改主机端口）

Docker Compose部署

创建docker-compose.yml文件，内容如下：

yaml
services:
  ugly-avatar:
    image: docker.xuanyuan.run/nasbump/ugly-avatar:latest
    container_name: ugly-avatar
    ports:
      - 9080:80
    restart: unless-stopped

执行以下命令启动服务：

bash
docker-compose up -d

配置说明：

• restart: unless-stopped：设置容器为除非手动停止否则自动重启，保证服务稳定性

访问服务

服务启动后，通过浏览器或API工具访问 http://<主机IP>:9080 即可使用头像生成功能。

注意事项

• 确保主机映射端口（如示例中的9080）未被其他服务占用，如需更换端口，修改-p参数中的主机端口部分
• 如需停止服务，可使用docker stop ugly-avatar（Docker Run方式）或docker-compose down（Docker Compose方式）