Image Hosting
Image hosting configuration guide to help you set up image upload functionality, supporting GitHub, SM.MS, PicGo, S3, and other image hosting services.
Enable Image Hosting
When image hosting is enabled, uploaded images will be automatically saved to the configured image hosting service.
Primary Image Hosting
Select GitHub, SM.MS, PicGo, or S3 as the primary image hosting. Settings take effect only after configuration.
GitHub Image Hosting
Use GitHub repository to store images.
Configuration Items
| Item | Description |
|---|---|
| Repository | GitHub repository for storing images |
| Branch | Repository branch name |
| Token | GitHub Personal Access Token |
jsDelivr Acceleration
When enabled, image links will use jsDelivr CDN acceleration to improve domestic access speed.
Note: GitHub image hosting requires creating a public repository, otherwise images will not be accessible.
Access Token Permissions
We recommend a GitHub fine-grained personal access token:
-
Existing image repository: under Repository access, select only the image repository and set
Contents: Read and write. -
Let NoteGen create it: set Repository access to
All repositories, then setContents: Read and writeandAdministration: Read and write. After creation, consider replacing it with a new token limited to the image repository. -
GitHub includes
Metadata: Readautomatically; no additional setting is required. -
Create a GitHub fine-grained personal access token: prefills no expiration, Contents, and Administration.
GitHub still asks you to confirm the resource owner and repository access.
SM.MS Image Hosting
Use SM.MS image hosting service to store images.
Configuration Items
| Item | Description |
|---|---|
| API Key | SM.MS API key |
Storage Usage
Displays the current storage space usage of the SM.MS account.
PicGo Image Hosting
Upload images via PicGo service. Requires PicGo application to be started first.
Configuration Items
| Item | Description |
|---|---|
| Service URL | PicGo service address, default is http://127.0.0.1:36677/upload |
S3 Image Hosting
Use AWS S3 or S3 API-compatible storage services.
Configuration Items
| Item | Description |
|---|---|
| Access Key | Access key ID |
| Secret Key | Secret access key |
| Bucket | Bucket name |
| Region | Bucket region |
| Endpoint | S3-compatible service URL; AWS can use its default |
| Custom Domain | Optional CDN acceleration domain |
| Path Prefix | Prefix used to organize images inside the bucket |
Compatible Services
S3 image hosting supports the following services:
- AWS S3
- Alibaba Cloud OSS
- Tencent Cloud COS
- Qiniu Cloud
- MinIO
- Other S3 API-compatible services