Image Hosting Guide

Image hosting determines where images from clipped content are stored. Proper image hosting configuration ensures images remain accessible long-term, avoiding image loss or display issues.

---

Table of Contents

1. Why Configure Image Hosting
2. Four Options Compared
3. Alibaba Cloud OSS Setup
4. Tencent Cloud COS Setup
5. Cloudflare R2 Setup
6. Notion Direct Upload
7. FAQ

---

1. Why Configure Image Hosting

The Problem

Many platforms (like Xiaohongshu, Weibo) have hotlink protection on images. Directly referencing original image URLs causes:

• Images appearing blank in Notion
• Images expiring after some time
• Images failing to load when viewed across platforms

The Solution

With image hosting configured, ETN will:

1. Download original images
2. Upload to your image host
3. Use image host URLs in Notion

This way images are permanently stored in your own storage space, free from original platform restrictions.

---

2. Four Options Compared

Option	Cost	Setup Difficulty	Best For
Alibaba Cloud OSS	~$0.15-0.70/month	Medium	China users (recommended)
Tencent Cloud COS	~$0.15-0.70/month	Medium	Tencent Cloud users
Cloudflare R2	10GB free	Higher	Global users, tech-savvy users
Notion Direct	Free (limited)	Zero config	Light usage

Recommendations

• China users: Alibaba Cloud OSS (fast access, stable)
• Global users: Cloudflare R2 (global CDN, generous free tier)
• Light usage: Notion Direct (no config needed, has storage limits)

---

3. Alibaba Cloud OSS Setup

3.1 Create OSS Bucket

1. Log in to Alibaba Cloud Console
2. Click "Bucket List" → "Create Bucket"
3. Configure:
   • Bucket Name: Custom, e.g., my-etn-images
   • Region: Choose nearest region (e.g., "China East 1 - Hangzhou")
   • Storage Class: Standard
   • ACL: Public Read (important!)
4. Click "OK" to create

3.2 Get AccessKey

1. Click avatar top-right → "AccessKey Management"
2. Click "Create AccessKey"
3. After security verification, note down:
   • AccessKey ID
   • AccessKey Secret

Security Tip

AccessKey Secret is shown only once, save it immediately. Recommend creating sub-account AccessKey with only OSS permissions.

3.3 Get Endpoint

On Bucket overview page, find "Access Domain" section, copy "External Endpoint", format like:

oss-cn-hangzhou.aliyuncs.com

3.4 Configure in ETN

1. Mini Program → Profile → Image Hosting
2. Toggle "Image Hosting" switch on
3. Select provider "Alibaba Cloud"
4. Fill in configuration:

Field	Example
Endpoint	oss-cn-hangzhou.aliyuncs.com
AccessKey ID	LTAI5t...
AccessKey Secret	your secret
Bucket Name	my-etn-images

5. Click "Save"

---

4. Tencent Cloud COS Setup

4.1 Create Bucket

1. Log in to Tencent Cloud COS Console
2. Click "Bucket List" → "Create Bucket"
3. Configure:
   • Name: Custom, e.g., etn-images
   • Region: Choose nearest region
   • Access Permission: Public Read, Private Write
4. Click "OK" to create

4.2 Get Keys

1. Go to API Key Management
2. Click "Create Key"
3. Note down:
   • SecretId (corresponds to AccessKey ID)
   • SecretKey (corresponds to AccessKey Secret)

4.3 Get Configuration Info

From bucket "Basic Configuration" page, get:

• Region: e.g., ap-guangzhou
• Bucket Name: e.g., etn-images-1234567890

4.4 Configure in ETN

1. Mini Program → Profile → Image Hosting
2. Enable image hosting, select "Tencent Cloud"
3. Fill in:

Field	Example
Region Name	ap-guangzhou
AccessKey ID	AKIDxxxxx
AccessKey Secret	your secret
Bucket Name	etn-images-1234567890

4. Click "Save"

---

5. Cloudflare R2 Setup

Cloudflare R2 offers 10GB free storage, ideal for global users or cost-conscious users.

5.1 Create R2 Bucket

1. Log in to Cloudflare Dashboard
2. Select "R2 Object Storage" from left menu
3. Click "Create bucket"
4. Enter bucket name, e.g., etn-images
5. Select location (recommend "Automatic")
6. Click "Create bucket"

5.2 Enable Public Access

1. Enter bucket → "Settings"
2. Find "Public access" section
3. Click "Allow access" to enable .r2.dev domain

Or configure a custom domain for better access speed.

5.3 Create API Token

1. On R2 page right side, click "Manage R2 API Tokens"
2. Click "Create API token"
3. Configure permissions:
   • Permissions: Object Read & Write
   • Bucket: Select the bucket you created
4. Click "Create API Token"
5. Note down:
   • Access Key ID
   • Secret Access Key

5.4 Get Endpoint

Endpoint format:

https://[account-id].r2.cloudflarestorage.com

Account ID can be found on the right side of Cloudflare dashboard.

5.5 Configure in ETN

1. Mini Program → Profile → Image Hosting
2. Enable image hosting, select "Cloudflare R2"
3. Fill in:

Field	Example
Endpoint	https://abc123.r2.cloudflarestorage.com
Access Key ID	your Access Key ID
Secret Access Key	your Secret Access Key
Bucket Name	etn-images
Custom Domain (optional)	https://cdn.yourdomain.com
Folder Path (optional)	images/etn/

4. Click "Save"

---

6. Notion Direct Upload

If you don't want to configure image hosting, you can use Notion to store images directly.

How to Use

1. Mini Program → Profile → Image Hosting
2. Enable image hosting, select "Notion"
3. Click "Save"

Notes

Item	Description
Storage Space	Limited by Notion plan (free tier: 5MB/file)
Upload Speed	Relatively slower
Access Speed	May be slow in some regions
Best For	Light users with few images

Space Limits

Notion free tier limits single files to 5MB, larger files will fail to upload. Recommend cloud storage for paid users or those with many images.

---

7. FAQ

Q: After configuring image hosting, will previous clips' images change?

A: No. Image hosting configuration only affects new clips. Previously saved content is unaffected.

Q: Does image hosting configuration work in the extension too?

A: Yes. Image hosting configuration is shared across all platforms. After configuring in mini program, Chrome extension clips will use the same image host.

Q: What if image upload fails?

A: Check these points:

1. Is image hosting switch enabled
2. Is configuration info correct (especially keys)
3. Is bucket permission set to "Public Read"
4. Is storage space sufficient

Q: Can I change image hosts?

A: Yes, anytime. After switching, new clips use the new host. Already saved images remain on the original host.

Q: How much does image hosting cost?

A: Using Alibaba Cloud OSS as example:

• Storage: ~$0.017/GB/month
• Bandwidth: ~$0.035/GB (external download)
• Average user (100 images/month): ~$0.15-0.50/month

Q: What happens without image hosting?

A: Images from some platforms (Xiaohongshu, Weibo, etc.) may not display in Notion due to hotlink protection. Recommend configuring image hosting to ensure long-term image accessibility.

---

Screenshots Needed

The following locations need screenshots:

1. Alibaba Cloud OSS

   • Create Bucket page
   • AccessKey Management page
   • Endpoint location

2. Tencent Cloud COS

   • Create Bucket page
   • API Key page

3. Cloudflare R2

   • R2 Console
   • Create API Token page

4. ETN Configuration Page

   • Image Hosting configuration page

---

For help, tap "Contact Support" in the mini program Profile to add our WeChat.