{"id":25177514,"url":"https://github.com/yestool/imguu","last_synced_at":"2025-04-04T02:40:39.128Z","repository":{"id":276582675,"uuid":"929257392","full_name":"yestool/imgUU","owner":"yestool","description":"ImageHosting Github login + Cloudflare R2 + D1 + Astro SSR | 图床\u0026图片上传","archived":false,"fork":false,"pushed_at":"2025-03-13T06:23:22.000Z","size":41,"stargazers_count":43,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T07:27:04.983Z","etag":null,"topics":["astro","cloudflare","image-hosting"],"latest_commit_sha":null,"homepage":"https://imguu.net","language":"Astro","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yestool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-02-08T05:48:36.000Z","updated_at":"2025-03-13T06:23:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"207fc36c-727c-4b26-ac8b-875852496c9a","html_url":"https://github.com/yestool/imgUU","commit_stats":null,"previous_names":["yestool/imguu"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yestool%2FimgUU","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yestool%2FimgUU/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yestool%2FimgUU/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yestool%2FimgUU/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yestool","download_url":"https://codeload.github.com/yestool/imgUU/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247112739,"owners_count":20885605,"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":["astro","cloudflare","image-hosting"],"created_at":"2025-02-09T14:25:41.680Z","updated_at":"2025-04-04T02:40:39.121Z","avatar_url":"https://github.com/yestool.png","language":"Astro","funding_links":["https://buymeacoffee.com/3dqjgnimhl"],"categories":[],"sub_categories":[],"readme":"[简体中文](./README.zh-CN.md) · **English**\n\n# imgUU - ImageHosting Github login + Cloudflare R2 + D1 + Astro SSR\n\n## Project Overview\n\nThis project is an open-source image upload tool designed to help users easily upload images to a Cloudflare R2 bucket and manage their image hosting needs. It provides a simple and efficient way to integrate with Cloudflare R2, allowing users to host images for free while maintaining full control over their data.\n\n![](https://imgs.imguu.net/2025/2/9/60a6d0fdb1f8f1ebf828dafefd1cf4fc.webp)\n\n\n## Features\n\n- **Free and Open-Source**: This tool is completely free and open-source, allowing users to modify and extend it according to their needs.\n- **Cloudflare R2 Integration**: Seamlessly integrates with Cloudflare R2, leveraging its reliable and scalable storage infrastructure.\n- **Customizable Configuration**: Users can easily configure the tool to match their specific requirements, including bucket settings and domain associations.\n- **User-Friendly Interface**: The tool provides an intuitive and user-friendly interface for uploading images and managing uploads.\n- **Support for Multiple Formats**: Supports various image formats and can be extended to support additional formats as needed.\n\n\n## Open Source \u0026 imguu.net\n\n|    feature     | Open Source   | imguu.net |\n|----------------|---------|--------|\n| Github login  | ✅     | ✅     |\n| Upload website config     | ✅     | ✅     |\n| Storage config      | ✅     | ✅     |\n| Upload records    | ✅     | ✅     |\n| Convert to WebP    | ❌     | ✅     |\n\n\n## Getting Started\n\n### Prerequisites\n\n- A Cloudflare account.\n- A domain that is already configured with Cloudflare.\n\n### Setup\n\n[Deatil Doc](https://imguu.net/doc/)\n\n\n1. **Create a Cloudflare R2 Bucket**:\n   - Log in to your Cloudflare account.\n   - Navigate to the **R2 Object Storage** section.\n   - Create a bucket named `imguu` (or any name you prefer).\n   - Set the location based on your target audience's region and choose the standard storage class.\n\n2. **Create an API Token**:\n   - Create an API token with access to the specified bucket.\n   - Set the TTL to permanent (or as needed).\n   - After creation, you will receive the following configuration parameters:\n     - `accessKeyId`\n     - `secretAccessKey`\n     - `accountId`\n\n3. **Associate the Bucket with a Domain**:\n   - Navigate to the `imguu` bucket settings.\n   - Enter a domain (either the main domain or a subdomain) hosted on Cloudflare.\n   - Follow the prompts to connect the domain with the bucket.\n\n4. **Configure the Tool**:\n   - Log in to the tool using your GitHub account.\n   - Enter the bucket configuration details obtained from Cloudflare.\n   - Set up the upload site and path templates as needed.\n\n5. **Upload and Test**:\n   - Select the upload site.\n   - Drag and drop or copy and paste images into the upload window.\n   - Click \"Upload\" to start the process.\n\n6. **View Upload Records**:\n   - You can view the upload records in the tool's backend.\n\n\n## Deploy Self\n\n1. Get github login config\n\n  github.com -\u003e Settings -\u003e Developer Settings -\u003e OAuth Apps -\u003e New OAuth App\n\n2. Config `.env`\n\n  ```\n  cp .env.example .env\n  ```\n\n3. Init D1 database\n\n  ```\n  npm run initSql\n  ```\n\n4. Deploy\n\n  ```\n  npm run deploy\n  ```\n\n\n## Contributing\n\nWe welcome contributions from the community! If you would like to contribute, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature or fix.\n3. Make your changes and commit them.\n4. Push your changes to your fork.\n5. Submit a pull request to the main repository.\n\n## Support\n\nIf you encounter any issues or have questions, please feel free to open an issue on the GitHub repository. We are here to help!\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Acknowledgements\n\nThis project is inspired by the need for a simple and efficient image hosting solution. Special thanks to the [Cloudflare](https://www.cloudflare.com) team for providing such a powerful and reliable storage service.\n\n\n[![](https://webviso.yestool.org/buymeacoffee.png)](https://buymeacoffee.com/3dqjgnimhl)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyestool%2Fimguu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyestool%2Fimguu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyestool%2Fimguu/lists"}