如何处理本地图片上传？

[yibie]

如题。

不太理解 README 中对 uploader 的解释

[Eliot00]

当你的文档中存在：

[[./image.png]]

并且配置了：

[image]
uploader = "oss-uploader"

点击上传图片就会调用oss-uploader ./image.png

[yibie]

我还有一个疑问，一般 uploader 会是哪些？

[Eliot00]

一般来说是要自定义脚本，如果有时间我可能会加上几个常见的OSS的快捷处理办法。

这里用DeekSeek针对阿里云OSS生成了一个bash脚本：

以下是一个实现阿里云 OSS 上传的 bash 脚本示例，你可以将其保存为 oss-uploader 并赋予执行权限：

#!/bin/bash

# 获取文件路径参数
file_path="$1"

# 检查参数是否存在
if [ -z "$file_path" ]; then
    echo "Error: Please provide a file path."
    exit 1
fi

# 检查文件是否存在
if [ ! -f "$file_path" ]; then
    echo "Error: File '$file_path' does not exist."
    exit 1
fi

# 检查 ossutil 是否可用
if ! command -v ossutil &> /dev/null; then
    echo "Error: ossutil is not installed or not in PATH."
    exit 1
fi

# 检查环境变量配置
if [ -z "$OSS_ENDPOINT" ] || [ -z "$OSS_BUCKET" ] || [ -z "$OSS_ACCESS_KEY_ID" ] || [ -z "$OSS_ACCESS_KEY_SECRET" ]; then
    echo "Error: Required OSS environment variables not set."
    echo "Please set: OSS_ENDPOINT, OSS_BUCKET, OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET"
    exit 1
fi

# 提取文件名
filename=$(basename "$file_path")

# 执行上传命令
echo "Uploading $file_path to OSS..."
ossutil cp "$file_path" "oss://$OSS_BUCKET/$filename" \
    --endpoint "$OSS_ENDPOINT" \
    --access-key-id "$OSS_ACCESS_KEY_ID" \
    --access-key-secret "$OSS_ACCESS_KEY_SECRET"

# 检查上传结果
if [ $? -ne 0 ]; then
    echo "Error: Upload failed!"
    exit 1
fi

# 生成访问 URL（假设为公共读存储空间）
echo "Upload successful!"
echo "OSS URL: https://$OSS_BUCKET.$OSS_ENDPOINT/$filename"

---

使用说明

1. 安装 ossutil
   前往阿里云 ossutil 文档下载并配置命令行工具

2. 设置环境变量
   在 ~/.bashrc 或 ~/.zshrc 中添加以下配置（替换为你的实际信息）：

   export OSS_ENDPOINT="oss-cn-beijing.aliyuncs.com"  # 你的 OSS Endpoint
   export OSS_BUCKET="your-bucket-name"               # 你的存储桶名称
   export OSS_ACCESS_KEY_ID="your-access-key-id"      # 你的 AccessKey
   export OSS_ACCESS_KEY_SECRET="your-access-key-secret"

3. 赋予脚本执行权限

   chmod +x oss-uploader

4. 测试上传
   执行命令上传测试文件：

   ./oss-uploader ./test-image.png

---

功能特点

1. 参数验证

   • 检查文件是否存在
   • 验证必要的环境变量是否已配置
   • 检查 ossutil 是否可用

2. 安全认证
   通过阿里云 AccessKey 进行身份验证（建议使用子账号并授予最小权限）

3. URL 生成
   自动生成符合阿里云 OSS 格式的公开访问 URL（需确保存储桶为公共读或配置了正确的权限）

4. 错误处理

   • 文件不存在时返回错误码 1
   • 上传失败时返回错误码 1
   • 所有错误均有明确英文错误提示

---

进阶优化建议

1. 添加重试机制
   在 ossutil 命令前添加重试逻辑，例如使用 for 循环尝试 3 次上传

2. 支持自定义路径
   通过添加 OSS_PATH_PREFIX 环境变量支持上传到指定子目录

3. 文件 Hash 校验
   在上传完成后，通过 ossutil sign 生成临时 URL 进行下载校验

4. 日志记录
   添加 >> upload.log 记录所有上传操作的时间戳和结果

需要实现上述进阶功能时，可以进一步扩展脚本逻辑。