https://github.com/yestool/imguu
ImageHosting Github login + Cloudflare R2 + D1 + Astro SSR | 图床&图片上传
https://github.com/yestool/imguu
astro cloudflare image-hosting
Last synced: 21 days ago
JSON representation
ImageHosting Github login + Cloudflare R2 + D1 + Astro SSR | 图床&图片上传
- Host: GitHub
- URL: https://github.com/yestool/imguu
- Owner: yestool
- License: mit
- Created: 2025-02-08T05:48:36.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-13T06:23:22.000Z (about 1 month ago)
- Last Synced: 2025-03-13T07:27:04.983Z (about 1 month ago)
- Topics: astro, cloudflare, image-hosting
- Language: Astro
- Homepage: https://imguu.net
- Size: 40 KB
- Stars: 43
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[简体中文](./README.zh-CN.md) · **English**
# imgUU - ImageHosting Github login + Cloudflare R2 + D1 + Astro SSR
## Project Overview
This 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.
## Features
- **Free and Open-Source**: This tool is completely free and open-source, allowing users to modify and extend it according to their needs.
- **Cloudflare R2 Integration**: Seamlessly integrates with Cloudflare R2, leveraging its reliable and scalable storage infrastructure.
- **Customizable Configuration**: Users can easily configure the tool to match their specific requirements, including bucket settings and domain associations.
- **User-Friendly Interface**: The tool provides an intuitive and user-friendly interface for uploading images and managing uploads.
- **Support for Multiple Formats**: Supports various image formats and can be extended to support additional formats as needed.
## Open Source & imguu.net
| feature | Open Source | imguu.net |
|----------------|---------|--------|
| Github login | ✅ | ✅ |
| Upload website config | ✅ | ✅ |
| Storage config | ✅ | ✅ |
| Upload records | ✅ | ✅ |
| Convert to WebP | ❌ | ✅ |
## Getting Started
### Prerequisites
- A Cloudflare account.
- A domain that is already configured with Cloudflare.
### Setup
[Deatil Doc](https://imguu.net/doc/)
1. **Create a Cloudflare R2 Bucket**:
- Log in to your Cloudflare account.
- Navigate to the **R2 Object Storage** section.
- Create a bucket named `imguu` (or any name you prefer).
- Set the location based on your target audience's region and choose the standard storage class.
2. **Create an API Token**:
- Create an API token with access to the specified bucket.
- Set the TTL to permanent (or as needed).
- After creation, you will receive the following configuration parameters:
- `accessKeyId`
- `secretAccessKey`
- `accountId`
3. **Associate the Bucket with a Domain**:
- Navigate to the `imguu` bucket settings.
- Enter a domain (either the main domain or a subdomain) hosted on Cloudflare.
- Follow the prompts to connect the domain with the bucket.
4. **Configure the Tool**:
- Log in to the tool using your GitHub account.
- Enter the bucket configuration details obtained from Cloudflare.
- Set up the upload site and path templates as needed.
5. **Upload and Test**:
- Select the upload site.
- Drag and drop or copy and paste images into the upload window.
- Click "Upload" to start the process.
6. **View Upload Records**:
- You can view the upload records in the tool's backend.
## Deploy Self
1. Get github login config
github.com -> Settings -> Developer Settings -> OAuth Apps -> New OAuth App
2. Config `.env`
```
cp .env.example .env
```
3. Init D1 database
```
npm run initSql
```
4. Deploy
```
npm run deploy
```
## Contributing
We welcome contributions from the community! If you would like to contribute, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or fix.
3. Make your changes and commit them.
4. Push your changes to your fork.
5. Submit a pull request to the main repository.
## Support
If you encounter any issues or have questions, please feel free to open an issue on the GitHub repository. We are here to help!
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Acknowledgements
This 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.
[](https://buymeacoffee.com/3dqjgnimhl)