qys123888/typewords

typewords 镜像文档

镜像概述

typewords是一个基于Web的应用镜像，主要提供打字练习或相关功能服务。该镜像通过3000端口对外提供Web访问界面，支持数据持久化存储，可通过容器化方式快速部署。

核心功能与特性

• Web服务访问：通过3000端口提供Web界面，支持浏览器访问使用
• 数据持久化：支持挂载主机目录到容器内部，确保应用数据不会因容器重启或删除而丢失
• 高可用性：建议配置自动重启策略，保证服务持续运行

使用场景

• 个人打字技能练习与提升
• 教学环境中的打字训练工具部署
• 需要快速搭建的打字相关Web应用服务

使用方法

基本部署（docker run）

通过以下命令快速部署typewords容器：

bash
docker run -d --restart=always \
  -p 3000:3000 \
  -v /vdb/typewords-data:/home/node/app \
  --name typewords \
  docker.xuanyuan.run/qys123888/typewords

参数说明：

• -d：后台运行容器
• --restart=always：容器退出时自动重启，确保服务持续可用
• -p 3000:3000：端口映射，将主机3000端口映射到容器3000端口，通过http://主机IP:3000访问服务
• -v /vdb/typewords-data:/home/node/app：数据卷挂载，将主机/vdb/typewords-data目录挂载到容器内/home/node/app路径，用于持久化存储应用数据
• --name typewords：指定容器名称为typewords，便于管理
• qys123888/typewords：使用的镜像名称

docker-compose配置示例

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

yaml
version: '3'
services:
  typewords:
    image: docker.xuanyuan.run/qys123888/typewords
    container_name: typewords
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - /vdb/typewords-data:/home/node/app

通过以下命令启动服务：

bash
docker-compose up -d

注意事项

• 确保主机/vdb/typewords-data目录存在且有适当权限，避免数据挂载失败
• 如需修改访问端口，可调整-p参数中的主机端口部分（如-p 8080:3000将使用8080端口访问）
• 容器运行后，可通过docker logs typewords查看应用日志排查问题