1.拉取代码

# 1. 拉取仓库
git clone https://github.com/a9086/aws-lightsail.git

# 2. 重命名文件夹
mv aws-lightsail lightsail-manager

# 3. 进入目录
cd lightsail-manager

2.准备环境变量

1.复制配置文件

cp .env.example .env

2.编辑 .env，务必修改：

SECRET_KEY=随机长字符串
ENCRYPTION_KEY=用下面命令生成
ADMIN_USERNAME=admin
ADMIN_PASSWORD=请改成强密码

# SECRET_KEY和ENCRYPTION_KEY的位数一定要对
SECRET_KEY=dZX8sAwVUXBZTLYNAK0IyEoAWt8nHj7YpYFzLFbAsDfXaPEgdC9pYh3dgLKNb0cc
ENCRYPTION_KEY=PDbvASgj_wacu7_smH_7Nyi3-E2bu5C4J1NMxDJ5Zzc=

3.生成 ENCRYPTION_KEY：

python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
# 或者
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

更换 ENCRYPTION_KEY 后，已绑定的 AWS Key 将无法解密，需要用户重新绑定。

3.构建docker启动

docker compose up -d --build

4.浏览器打开：http://localhost:8080

默认账号（若用户表为空时自动创建）：

• 用户名：admin（或 .env 中配置）
• 密码：admin123（或 .env 中配置）

使用流程

1. 使用管理员登录
2. （可选）在「用户管理」创建普通用户
3. 在「AWS 凭证」添加一组或多组 Access Key，并可设默认
4. 在「实例」查看已有机器（可按凭证筛选），或「开通实例」时选择使用哪组 Key
5. 在实例「限额」中设置月流量上限，并可选勾选「超限自动关机」
6. 在「流量」页可手动同步当月用量，查看地区汇总与超限告警

一.国外机器push到Docker Hub

在服务器上登录 docker hub 账号

docker login

查看镜像

docker images

tag修改镜像名称

docker tag lightsail-manager-backend:latest kenzsoft/lightsail-manager-backend:latest
docker tag lightsail-manager-frontend:latest kenzsoft/lightsail-manager-frontend:latest

push到Docker Hub

docker push kenzsoft/lightsail-manager-backend:latest
docker push kenzsoft/lightsail-manager-frontend:latest

二.国内机器拉取镜像，并docker compose up -d启动

• 从国外机器上下载构建docker用的docker-compose.yml和.env
• 修改docker-compose.yml，如图：
  
• 在国内机器上root目录新建文件夹“lightsail-manager”，把.env和修改好的docker-compose.yml上传到“lightsail-manager”文件夹内。

• 在国内机器上拉取镜像

  docker pull kenzsoft/lightsail-manager-backend:latest
  docker pull kenzsoft/lightsail-manager-frontend:latest

• 最后在“lightsail-manager”文件夹运行：

  docker compose up -d