Neko - Dictation

• 本项目是一款基于 Flask 框架开发的英语学习软件，集成了多项实用功能，旨在提升学习体验。主要功能包括单词听写练习、单词错误记录与分析、学习日志记录等，帮助大家更好地跟踪和提升英语学习进度。欢迎大家体验！
• 支持Win、Mac、Linux系统运行。部署在本地只能局域网（如同一WiFi）内通过浏览器（手机，平板等）访问。部署到公网后可以随时随地通过带有浏览器的电子设备访问。
• 验证码：wenpeng
• 项目在左边的发行（releases）里。下载最新的直接解压就好了。

如果不需要部署到云，直接本地运行即可。

部署 Neko-Dictation 到云服务器

以下步骤将以阿里云服务器（ECS）为例，指导如何将Neko-Dictation 项目部署到阿里云服务器（ECS），并且购买域名，将其绑定到服务器的 IP 地址。

1. 准备工作

• 打包后的项目下载链接：https://github.com/Summer-Neko/Neko-Dictation/releases/download/Neko-Dictationv1.0/Neko-DictationV1.0.zip
• 你可能还需要上传activation文件到你的云服务器对应目录
• 阿里云服务器（ECS）：确保你已经购买并启动了阿里云的 ECS 实例，并有公网 IP 地址。（新用户有三个月，建议选在香港。）
• SSH 工具：用于连接到阿里云服务器的工具，例如终端、Workbench（推荐） 或其他 SSH 客户端。

---

2. 连接到阿里云服务器(Workbench)

打开此网站并登录你的账号https://ecs.console.aliyun.com/，选择你创建的云服务器（实例），通过 Workbench 远程连接到你的阿里云服务器。

3. 下载并解压打包好的文件（以下由ChatGPT生成）

现在我们直接从 GitHub 下载本项目压缩包并解压。

1. 进入用户主目录：

   默认情况下，你登录的目录就是用户的主目录。可以通过命令进入用户主目录：

   cd ~

2. 使用 wget 下载压缩包：

   在阿里云服务器中，使用 wget 命令下载 本项目 压缩包：

   wget https://github.com/Summer-Neko/Neko-Dictation/releases/download/Neko-Dictationv1.0/Neko-DictationV1.0.zip

3. 安装 unzip（如果还没有安装）：

   unzip 可能不是默认安装。如果没有安装，可以通过以下命令安装：

   sudo yum install unzip  # CentOS 或 Red Hat 系系统

4. 解压文件：

   下载完成后，解压压缩包：

   unzip Neko-Dictation.V1.0.zip

   这会解压到一个名为 Neko-Dictation 的文件夹中。

5. 进入解压后的目录：

   cd Neko-Dictation

4. 运行打包好的程序

1. 赋予执行权限：

   如果文件没有执行权限，可以通过以下命令赋予权限：

   chmod +x Neko-Dictation

2. 运行可执行文件：

   直接运行程序：

   ./Neko-Dictation

5. 域名购买和绑定阿里云服务器

要通过域名访问阿里云服务器，你可以通过阿里云购买一个域名，并将其解析到你的服务器 IP 地址。

购买域名操作步骤：

1. 登录阿里云官网：

   打开浏览器，访问 阿里云官网 并登录你的账户。

2. 进入域名购买页面：

   在阿里云控制台的左侧导航栏中，找到 “域名与网站”，点击 “域名”，进入域名注册页面。

3. 搜索并购买域名：

   • 输入你想要的域名，点击搜索，找到可用的域名后，点击购买。
   • 按照页面提示完成支付，购买域名。

4. 域名解析：

   购买完成后，接下来需要将域名解析到阿里云服务器的 IP 地址。

   • 在阿里云控制台中，点击 “域名”，找到你购买的域名，点击 “解析”。
   • 添加一条解析记录：
     • 主机记录：填写 www 或留空表示主域名。
     • 记录类型：选择 A 记录。
     • 记录值：填写你的阿里云服务器的公网 IP 地址。

5. 等待生效：

   域名解析生效通常需要几分钟到一小时，完成后，你可以通过域名访问服务器。

6. 通过 IP 或域名访问应用

• 通过服务器 IP 地址访问：

  例如，如果你的服务器 IP 地址是 123.45.67.89，你可以通过：

  http://123.45.67.89

  直接访问你在该服务器上运行的应用程序。

• 通过域名访问：

  例如，如果你购买的域名是 example.com，你可以通过：

  http://example.com

  访问服务器上的应用。

7. 配置阿里云安全组规则

确保阿里云服务器的安全组规则允许外部访问你指定的端口（例如 80，8080）。

1. 登录阿里云控制台。
2. 在左侧导航栏中选择 “网络与安全” -> “安全组”。
3. 选择你的 ECS 实例，点击 “配置规则”。
4. 添加一个新的 入方向规则：
   • 端口：输入你应用监听的端口（如 80 或 8080）。
   • 授权对象：输入 0.0.0.0/0 以允许所有 IP 访问。

8. 将应用设置为后台运行

为了确保应用在你退出 SSH 会话后仍然继续运行，可以使用 nohup 或 screen ：

• 使用 nohup：

  nohup ./Neko-Dictation > output.log 2>&1 &

  这个命令会让程序在后台运行，并将输出记录到 output.log 文件中。

• 使用 screen：

  screen -S mysession
  ./Neko-Dictation

  使用 Ctrl + A 然后 D 可以退出 screen，但应用程序仍然在后台运行。