一、Qwerty Learner 介绍

1.1 Qwerty Learner 简介

Qwerty Learner 是一款专为以英语为主要工作语言的键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件。它旨在帮助用户在背诵和学习新单词的同时，强化其英语输入的肌肉记忆，解决因长期使用母语输入而造成的英语打字速度慢、“提笔忘字”的问题。该工具通过提供一种结合了单词记忆和实际键盘练习的方法，让用户能够在提高词汇量的同时，增强英语输入的准确性和速度，特别适合需要进行英语机考的人群。

1.2 主要特点

• 针对性强：针对英语作为第二语言的学习者，特别是那些日常工作中主要使用母语输入的键盘工作者，帮助他们克服英语输入时的速度和准确性问题。

• 结合记忆与实践：将传统的单词背诵与实际的键盘输入练习相结合，使用户不仅能记住单词，还能在实际输入中熟练运用这些单词，从而巩固正确的肌肉记忆。

• 错误纠正机制：为了防止形成错误的肌肉记忆，当用户输入错误时，系统会要求重新输入正确的单词，确保每次练习都在加强正确的输入模式。

• 辅助机考准备：对于需要参加英语机考的用户来说，这种类型的练习尤为重要，因为它不仅提高了用户的词汇量，还提升了他们在考试中的打字速度和准确性。

• 用户体验友好：设计考虑到了易用性，提供了清晰直观的界面，使得不论是刚开始学习英语还是希望进一步提升自己技能的用户都能轻松上手。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为|Ubuntu 22.04.1。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署Qwerty Learner英语单词学习工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2025-03-20 09:00:26 UTC; 1 day 9h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 2906 (dockerd)
      Tasks: 112
     Memory: 4.2G
        CPU: 2min 6.557s
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose version
Docker Compose version v2.19.1

四、构建镜像

4.1 下载项目

拉取Qwerty Learner项目，如下所示：

root@jeven01:~# git clone https://github.com/RealKai42/qwerty-learner.git
Cloning into 'qwerty-learner'...
remote: Enumerating objects: 12581, done.
remote: Counting objects: 100% (159/159), done.
remote: Compressing objects: 100% (66/66), done.
remote: Total 12581 (delta 129), reused 98 (delta 93), pack-reused 12422 (from 5)
Receiving objects: 100% (12581/12581), 183.74 MiB | 16.58 MiB/s, done.
Resolving deltas: 100% (8467/8467), done.

• 查看项目内容：

root@jeven01:~# cd qwerty-learner/
root@jeven01:~/qwerty-learner# ls
components.json      docs        package.json          prettier.config.js  scripts    tailwind.config.js  tsconfig.node.json
docker-compose.yaml  index.html  playwright.config.ts  public              src        tests               vite.config.ts
Dockerfile           LICENSE     postcss.config.js     README.md           src-tauri  tsconfig.json       yarn.lock

4.2 构建镜像

执行以下命令，构建Qwerty Learner容器镜像。

docker build -t qwertylearner .

镜像构建完毕后，查看本地容器镜像。

root@jeven01:~/qwerty-learner# docker images |grep  qwertylearner
qwertylearner                                                     latest    9b7b2426e29a   2 hours ago     131MB

五、部署Qwerty Learner应用

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/qwertylearner  &&  cd /data/qwertylearner

5.2 编辑部署文件

• 如果使用docker-cli部署，可使用以下命令。（可选）

 docker run -d --name qwerty -p 5200:5173 qwertylearner:latest

在`部署目录下，创建docker-compose.yaml文件，如下所示：

vim docker-compose.yaml

version: '3.9'
services:
    qwertylearner:
        image: 'qwertylearner:latest'
        ports:
            - '5200:5173'
        restart: always
        container_name: qwerty

5.3 创建qwertylearner容器

执行以下命令，创建qwertylearner容器。

root@jeven01:/data/qwertylearner# docker compose up -d
[+] Running 2/2
 ✔ Network qwertylearner_default  Created                                                                                                         0.1s
 ✔ Container qwerty               Started                                                                                                         0.2s

5.4 查看qwertylearner容器状态

检查qwertylearner容器状态状态，确保qwertylearner容器正常启动。

root@jeven01:/data/qwertylearner#  docker compose ps
NAME                IMAGE                  COMMAND                  SERVICE             CREATED             STATUS              PORTS
qwerty              qwertylearner:latest   "/docker-entrypoint.…"   qwertylearner       53 seconds ago      Up 52 seconds       80/tcp, 0.0.0.0:5200->5173/tcp, :::5200->5173/tcp

5.5 查看qwertylearner容器日志

检查qwertylearner容器日志，确保qwertylearner服务正常运行。

docker compose logs

六、访问Qwerty Learner服务

浏览器地址： http://<个人的服务器IP>:5200，访问Qwerty Learner服务的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

键盘任意键开始学习，如下所示：

七、总结

通过此次实践，我们成功利用Docker部署了Qwerty Learner英语单词学习工具，体验了从环境配置到应用访问的完整流程。这个过程不仅加深了对Docker容器化部署的理解，同时也展示了如何高效地搭建一个有助于提升英语输入技能的学习平台。部署完成后，用户可以方便地访问和使用Qwerty Learner，进行个性化的英语单词学习和肌肉记忆训练，极大地提高了学习效率和使用的便捷性。