{"id":24756797,"url":"https://github.com/weijunext/image-url-converter","last_synced_at":"2025-04-06T09:06:02.589Z","repository":{"id":274143955,"uuid":"922041697","full_name":"weijunext/image-url-converter","owner":"weijunext","description":"A simple tool that converts any image URL into a permanent link hosted on Cloudflare R2. Perfect for individuals or small projects needing image hosting services.","archived":false,"fork":false,"pushed_at":"2025-02-11T14:59:30.000Z","size":384,"stargazers_count":133,"open_issues_count":1,"forks_count":14,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T08:07:10.376Z","etag":null,"topics":["cloudflare","image-processing","logo","nextjs","r2"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/weijunext.png","metadata":{"files":{"readme":"README-zh.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-25T06:43:49.000Z","updated_at":"2025-03-20T12:37:50.000Z","dependencies_parsed_at":"2025-03-23T07:30:10.414Z","dependency_job_id":"7aca0062-4a91-41ec-a12d-e5c01c88179c","html_url":"https://github.com/weijunext/image-url-converter","commit_stats":null,"previous_names":["weijunext/image-url-converter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weijunext%2Fimage-url-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weijunext%2Fimage-url-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weijunext%2Fimage-url-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weijunext%2Fimage-url-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weijunext","download_url":"https://codeload.github.com/weijunext/image-url-converter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247457799,"owners_count":20941906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudflare","image-processing","logo","nextjs","r2"],"created_at":"2025-01-28T14:20:38.460Z","updated_at":"2025-04-06T09:06:02.563Z","avatar_url":"https://github.com/weijunext.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Image URL Converter\n\n这是一个简单的工具，可以将任意图片URL转换为托管在 Cloudflare R2 上的永久链接。适合需要图片托管服务的个人或小型项目使用。\n\n## 🎉 谁在使用\n\n- [Next Idea NewTab](https://newtab.nextidea.dev)\n\n## 📦 项目结构\n\n```\n/image-url-converter\n  ├── /image-converter-next     # Next.js 前端项目\n  └── /image-converter-worker   # Cloudflare Worker 项目\n```\n\n## 📌 功能特点\n\n- 简单易用：只需输入原始图片URL，即可获得永久链接\n- 全球加速：使用 Cloudflare CDN，访问速度快\n- 免费使用：利用 Cloudflare R2 的免费额度\n  - 每月 10GB 存储空间\n  - 每月 10GB 出站流量\n- 支持自定义域名\n- 完全免费部署\n\n## 📚 使用指南\n\n### 1. 准备工作\n\n\n1. 注册 [Cloudflare](https://dash.cloudflare.com/sign-up) 账号\n2. 安装 [Node.js](https://nodejs.org/) (版本 18.0.0 或更高)\n3. 安装 [pnpm](https://pnpm.io/) \n\n### 2. 配置 Cloudflare R2\n\n1. 登录 [Cloudflare 控制台](https://dash.cloudflare.com)\n2. 在左侧菜单找到并点击 \"R2\"\n3. 如果是首次使用，会提示创建结算账号，按提示完成即可（不会收费）\n4. 点击 \"Create bucket\" 创建存储桶\n   - Bucket name 填写：`images`（或你喜欢的名字）\n   - 点击 \"Create bucket\" 完成创建\n5. 在存储桶列表中点击刚创建的存储桶\n6. 点击 \"Settings\" 标签\n7. 找到 \"Public access\" 部分\n   - 开启 \"Public bucket\" 开关\n   - 如果有自己的域名，可以在下方设置自定义域名（比如：images.your-domain.com）\n   - 如果没有自己的域名，复制 \"Public bucket URL\" 备用\n8. 创建 API 令牌\n   - 点击右上角的 \"Manage R2 API Tokens\"\n   - 点击 \"Create API token\"\n   - 权限选择：Object Read \u0026 Write\n   - 点击 \"Create token\"\n   - 保存显示的信息：\n     * Access Key ID\n     * Secret Access Key\n\n注意：Secret Access Key 只显示一次，请务必保存！\n\n## 3. 本地使用步骤\n\n1. [Fork](https://github.com/weijunext/image-url-converter/fork) 这个项目到你的 GitHub 账号，然后克隆到本地\n\n\n```bash\ngit clone [repository-url]\ncd image-url-converter\n```\n\n### 2. 配置并运行 Worker\n\n```bash\n# 进入 Worker 项目目录\ncd image-converter-worker\n\n# 安装依赖\nnpm install\n\n# 安装 wrangler\nnpm install -g wrangler\n\n# 登录到 Cloudflare\nwrangler login\n\n# 部署 Worker\nwrangler deploy\n```\n\n### 3. 配置并运行 Next.js 应用\n\n```bash\n# 回到项目根目录\ncd ..\n\n# 进入 Next.js 项目目录\ncd image-converter-next\n\n# 安装依赖\nnpm install\n\n# 创建环境变量文件\ncp .env.example .env.local\n```\n\n编辑 `.env.local` 文件，填入以下信息：\n```\nR2_ACCOUNT_ID=你的Cloudflare账号ID（在Cloudflare主页右侧可以找到）\nR2_ACCESS_KEY_ID=你的R2 Access Key ID\nR2_SECRET_ACCESS_KEY=你的R2 Secret Access Key\nR2_BUCKET_NAME=你的存储桶名称（例如：images）\nR2_PUBLIC_URL=你的Public bucket URL\n```\n\n### 4. 运行开发服务器：\n```bash\nnpm run dev\n```\n\n现在可以访问 http://localhost:3000 使用工具了。\n\n## ⚙️ 使用方法\n\n1. 确保 Next.js 开发服务器正在运行\n2. 打开浏览器访问 http://localhost:3000\n3. 在输入框中粘贴图片 URL\n4. 点击\"转换\"按钮\n5. 等待处理完成，获取新的永久链接\n\n## ❓ 常见问题\n\nQ：免费额度够用吗？\nA：对于个人使用来说绰绰有余。每月 10GB 存储和 10GB 流量，可以存储数千张图片。\n\nQ：上传的图片会过期吗？\nA：不会。只要你的 Cloudflare 账号正常使用，图片就会一直保存。\n\nQ：上传速度慢怎么办？\nA：图片上传速度主要取决于原始图片所在服务器的响应速度。建议选择稳定的图片源。\n\nQ：支持哪些图片格式？\nA：支持所有常见的图片格式，包括 JPG、PNG、GIF、WebP 等。\n\n## 🔔 注意事项\n\n1. 请确保你要转换的图片URL是可以公开访问的\n2. 建议定期检查 R2 的使用量，避免超出免费额度\n3. 请勿上传违规或违法的图片内容\n\n## ☎️ 技术支持\n\n如果遇到问题：\n1. 可以在 GitHub Issues 中提问\n2. 可以查看 [Cloudflare R2 文档](https://developers.cloudflare.com/r2/)\n3. 可以访问 [Cloudflare 帮助中心](https://support.cloudflare.com/)\n\n## 📜 许可证\n\nMIT License","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweijunext%2Fimage-url-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweijunext%2Fimage-url-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweijunext%2Fimage-url-converter/lists"}