Credit to 胡大 Tutorial by boshi

钢琴社微信公众号后台基于Nginx+Python+Flask。

后台本体由单个文件夹组成：

• papuwx/
  • whls/
    • requirements.txt
  • log/
    • flask.log
  • conf.ini
  • courses.txt
  • db
  • default.ini
  • deploy.sh
  • main.py
  • music.db
  • music.py
  • patterns.py
  • performers.txt
  • processor.py
  • syncdb.sh
  • utils.py

要想让其成功运行，还需要在其所在的服务器正确配置nginx、python，还需要在微信控制台设置正确的服务器地址。

如果你是计算机大佬，这个文档可以帮你快速了解后台的运作模式，并在配置时帮助你少走许多弯路，另外还能帮助你为其开发一些新的功能。如果你是计算机小白，完全按照这个文档操作可以大概率保证公众号后台的正常运行和成功迁移。

如果下述信息在你接手维护钢琴社服务器的时候发生了改变，请修改本文档，以方便后人使用

在换届交接过程中，请将本文档交予下一任技术部负责人

目前使用的服务器正在与提琴社合租，提琴社方面也拥有一个root权限的账号

如果社团的服务器到期，续租的费用由社团承担，请联系当届的团支书进行报销

目前使用的服务在2022年8月到期前使用20级安博施的学生认证购买，如要续租请在学生认证界面续租，!!不要!!在控制台界面续租！！！

密码不要外泄！！！

如果你已经使用过腾讯云或阿里云或某提供商的虚拟云服务器（VPS），可以跳过本部分

用腾讯云注册邮箱登陆腾讯云后可以进入控制台查看服务器的底层信息，在这里可以做的事包括但不限于：

• 开关机
• 续费（不要在这里续费！！！在这里续费没有学生优惠）
• 升降配
• 查看公网ip
• 监控系统负载

通过服务器的密码，可以用 ssh 命令登陆服务器

在 ubuntu 下输入以下命令并在后续提示中输入密码即可登陆

ssh [email protected]

使用rsa密钥可以在使用上述命令时免去输入密码的麻烦

该方法的原理是根据你计算机独有的信息生成一个独有的密钥对，将私钥保存在本地的某个指定文件夹内，再将公钥追加到服务器上某个指定文件末尾，在ssh连接服务器时系统将会自动判断本地的私钥是否与服务器上的某个公钥匹配，弱匹配则不需要输入密码。

• 如果你是windows用户：

  • 在命令行输入

  • ssh-keygen -t rsa

  • 然后一路回车跳过所有多余的信息

  • 你将会在某个文件夹看到该命令生成的公钥id_rsa.pub和私钥id_rsa

  • 将私钥和公钥同时保存在C:\Users\你的用户名\.ssh下

  • 然后将公钥上传至服务器

  • cat id_rsa.pub | ssh 服务器用户@服务器IP "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

• 如果你是linux用户

  • 在命令行输入

  • ssh-keygen -t rsa

  • 然后一路回车跳过所有多余的信息

  • 你将会在 ~/.ssh 下看到公钥id_rsa.pub和私钥id_rsa

  • 然后将公钥上传至服务器

  • cat id_rsa.pub | ssh 服务器用户@服务器IP "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

连接到服务器后在终端输入

sudo adduser 新用户名

即可新建用户

再在 sudo vim /etc/sudoers 末尾追加：

新用户名 ALL=(ALL) ALL

即可给新用户添加root权限

如果你获得了一个新的服务器，并希望将微信后台迁移到新服务器，可以参考这部分内容。

当然似乎该服务也可以通过uwsgi运行，稳定性更高，在之前的服务器上是这么运行的，然而笔者技术水平过低，只能用比较笨的方法让服务运行起来

1. 首先我们需要在新服务器安装nginx：

   sudo apt install nginx
   service nginx start  # 启动nginx
   service nginx reload  # 重新加载nginx配置文件

2. 然后nginx就安装好了，下一步是将旧的公众号后台迁移（全部拷贝）过来：

   在旧的服务器终端输入：

   scp -r /var/www/papuwx/ ubuntu@新服务器地址:/var/www/papuwx/

   于是整个公众号后台都被迁移过来了。

3. 发挥你的聪明才智，安装Python3.6（一般的服务器会自带）以及venv模块

   sudo apt install python3-venv

4. 删除原有的python虚拟环境

   sudo rm -r /var/www/papuwx/papuwx_venv

5. 创建新的python虚拟环境

   cd /var/www/papuwx
   python3 -m venv papuwx_venv

6. 激活新的python虚拟环境

   source papuwx_venv/bin/activate

7. 安装依赖库

   pip install -r ./whls/requirements.txt

8. 配置nginx

   修改nginx的配置文件/etc/nginx/sites-avilable/default：

   sudo nano /etc/nginx/sites-avilable/default

   并在原有的

   	location / {
   		# First attempt to serve request as file, then
   		# as directory, then fall back to displaying a 404.
   		try_files $uri $uri/ =404;
   	}

   后面追加：

   	# papuwx
   	location = /papuwx {rewrite ^ /papuwx/;}
   	location /papuwx/ {
   		include uwsgi_params;
   		uwsgi_pass unix:/var/run/nginx/papuwx.sock;
   	}

9. 至此为止，服务器上的配置工作基本完工，先尝试在虚拟环境内运行后台：

   确保自己在papuwx_venv的虚拟环境内（执行source papuwx_venv/bin/activate进入虚拟环境，deactivate退出）

   cd /var/www/papuwx/
   python main.py runserver

   如果可以成功运行（有红色的警告也不管他（真的不用管）），那么恭喜你可以继续了

   如果不能成功运行，请自行解决或联系上一届技术部成员寻求帮助

10. 接下来尝试修改微信设置，将公众号消息转发给服务器

    进入公众号管理平台 https://mp.weixin.qq.com/

    将“设置与开发”栏目的“基本配置”中的“服务器配置(已启用)”下的“服务器地址”改成http://新服务器地址/papuwx/

    如果成功修改，那么恭喜你，公众号后台上线了，快去发消息调戏

    如果不能成功修改，请自行解决或联系上一届技术部成员寻求帮助

11. 接下来只需要将运行程序的命令打包成一个服务开机自启后台运行即可

    cd /etc/init.d/
    touch pkupiano.sh
    sudo nano pkupiano.sh

    然后在打开的文件pkupiano.sh内写入：

    sudo nohup /var/www/papuwx/papuwx_venv/bin/python3 /var/www/papuwx/main.py runserver >> /var/www/papuwx/log/flask.log 2>&1 &
    
    exit 0

    然后将该脚本赋予可执行权限并设置为开机启动：

    sudo chmod 777 pkupiano.sh
    sudo update-rc.d pkupiano.sh defaults 90

    要是发现程序没有在运行想要手动运行，只需要找到这个.sh文件并执行这个文件即可

• 也许是服务器挂了

  检查以下服务器有没有在运行

• 也许是服务没有在运行

  这时好办，手动运行上面提到的pkupiano.sh即可

• 也许是服务崩溃了

  找到服务并且把它杀死然后再运行一遍

  找到这个服务的方法是

  sudo netstat -tunlp | grep 5000

  在输出结果最后可以找到服务的进程号和进程名（格式应该是进程号/python3）（如果没有输出结果表示服务没有在运行，或者服务被修改过导致其没有监听5000端口）

  然后把他杀死（XXXX为进程号）

  sudo kill XXXX

• 也许是系统崩溃了

  可以重启整个服务器

  请务必联系所有可能在使用服务器的人，经过同意再重启，因为由于该服务器是公用服务器，可能有其他服务在该服务器上运行，目前有提琴社同学在使用

  重启的代价较大，请三思而后行

• 可以去瞅瞅 /var/www/papuwx/log/flask.log里面记录了所有人调戏公众号的记录以及预约琴房等记录，但是读起来很不方便
• 还可以去瞅瞅腾讯云控制台的监控界面，系统负载一目了然

1. 切换路径到/var/www/papuwx下

   经过上面的教学你一定已经学会了！请发挥你的聪明才智！

2. 修改当前目录下的 main.py 的 refreshCourses 函数，将其中的 startDate 和 endDate 变量修改为本学期钢琴课的起止日期

   不会的话问问身边会Python的大佬

3. 将 /var/www/papuwx 下的 course.txt 修改为新的选课名单

4. 进入虚拟环境

   经过上面的教学你一定已经学会了！请发挥你的聪明才智！

5. 刷新

   sudo python3 main.py refreshcourses

   该操作会显示：”Old courses will be deleted, are you sure? ”

   输入”Yes”后即刷新选课名单，（当然也可以输入yes,Y,y）