宝塔面板使用qshell上传文件到七牛云OSS教程

宝塔面板使用qshell上传文件到七牛云OSS教程

本教程详细介绍在宝塔Linux面板中，通过qshell工具将本地文件上传到七牛云OSS的操作步骤，适合网站静态资源管理。

一、准备工作

1. 七牛云信息收集

1. 登录七牛云控制台，创建存储空间（Bucket），记录空间名称（例：my-bucket）；

2. 获取AccessKey和SecretKey（路径：个人中心→密钥管理）；

3. 记录存储空间区域（例：华东z0、华北z1）。

2. 本地文件路径确认

确定本地需上传目录的绝对路径（例：/www/wwwroot/你的域名/upload）。

二、登录宝塔面板并打开终端

1. 访问宝塔面板：http://服务器IP:8888，输入账号密码登录；

2. 左侧菜单找到「终端」，验证密码后进入命令行界面。

三、安装qshell工具

在终端执行以下命令：

# 下载qshell（64位系统）
wget https://github.com/qiniu/qshell/releases/latest/download/qshell-linux-amd64 -O /usr/local/bin/qshell

# 赋予执行权限
chmod +x /usr/local/bin/qshell

# 验证安装是否成功
qshell version

提示版本信息即为安装成功。

四、配置七牛云账号

qshell account 你的AccessKey 你的SecretKey "自定义名称"

将「你的AccessKey」和「你的SecretKey」替换为实际密钥。

五、创建上传配置文件

1. 新建配置文件

1. 宝塔面板左侧「文件」→ 进入/root目录；

2. 新建文件，命名为qupload.conf并编辑。

2. 配置文件内容

{
    "src_dir": "/www/wwwroot/你的域名/upload",
    "bucket": "my-bucket",
    "overwrite": true,
    "rescan_local": true,
    "key_prefix": "目标目录/",
    "log_file": "/root/qshell_upload.log",
    "thread_count": 5
}

3. 关键参数说明

• src_dir：本地待上传目录路径；

• bucket：七牛云存储空间名称；

• key_prefix：七牛云中的目标存储目录；

• overwrite：true表示覆盖已有文件；

• rescan_local：true表示重新扫描本地文件。

六、执行上传操作

qshell qupload /root/qupload.conf

执行后将显示上传进度，完成后输出统计结果。

七、验证上传结果

1. 查看上传日志：

   cat /root/qshell_upload.log

2. 登录七牛云控制台，进入对应存储空间查看文件是否存在。

八、设置定时上传（可选）

1. 宝塔面板「计划任务」→「添加任务」；

2. 任务类型：Shell脚本，设置执行周期；

3. 脚本内容：

   /usr/local/bin/qshell qupload /root/qupload.conf

4. 保存后将自动定期执行。

九、常见问题解决

• 权限错误：

  chmod -R 755 /www/wwwroot/你的域名/upload

• 上传速度慢：修改配置文件中thread_count参数（如改为10）；

• 上传失败：查看/root/qshell_upload.log日志排查原因。

• 喜欢（11）
• 不喜欢（1）

本文链接：https://www.liumangahui.com/post/72.html