STLViewer зазвичай зберігає завантажені моделі у вбудованому сховищі. Якщо ви хочете, щоб самі файли моделей були в обліковому записі, який контролюєте ви, можна підключити кошик Cloudflare R2. Після цього нові моделі, завантажені з вашого облікового запису, зберігатимуться у вашому кошику.

У Cloudflare "кошик" означає просто місце для файлів. Вам не потрібно запускати сервер, налаштовувати Cloudflare Workers, мати власний домен або користуватися терміналом.

Цей посібник показує весь процес: створення кошика, створення безпечного ключа доступу, підключення в STLViewer і те, що відбувається після цього. Зазвичай це займає близько 10-15 хвилин.

Що зміниться

• Нові моделі потрапляють у ваш кошик R2. Після ввімкнення підключення кожна нова модель, завантажена з вашого облікового запису, буде збережена саме там.
• Попередні моделі залишаються на місці. Моделі, завантажені раніше, і далі працюють у вбудованому сховищі STLViewer. Ми не переносимо їх автоматично.
• Файли залишаються в R2, якщо ви відключите сховище. Відключення видаляє записи моделей зі STLViewer, але не видаляє файли з вашого кошика.
• CORS налаштовувати не потрібно. STLViewer читає файл із кошика і передає його через застосунок. Браузер людини, яка переглядає модель, не підключається до вашого кошика напряму.
• Моделі в R2 не використовують ліміт сховища STLViewer. Файли зберігаються у вашому обліковому записі Cloudflare.

Ця функція доступна тільки для зареєстрованих користувачів. Завантаження без облікового запису завжди використовують вбудоване сховище.

Перед початком

Вам потрібно:

• обліковий запис Cloudflare з увімкненим R2
• обліковий запис STLViewer, у який ви ввійшли
• спосіб оплати в Cloudflare, бо Cloudflare просить його під час увімкнення R2, навіть якщо ви залишаєтеся на безкоштовному плані

Крок 1 - Створіть кошик R2

1. Увійдіть до панелі Cloudflare.
2. Відкрийте R2 Object Storage.
3. Натисніть Create bucket.
4. Дайте кошику просту назву, наприклад stlviewer-models. Назви кошиків пишуться малими літерами, і їх не можна змінити пізніше.
5. Залиште розташування за замовчуванням, якщо у вас немає конкретної причини вибрати регіон.
6. Натисніть Create bucket.

Крок 2 - Створіть API-токен R2

Токен - це ключ, який STLViewer використовує, щоб зберігати моделі в кошику і читати їх, коли хтось відкриває поширену модель.

1. На сторінці R2 Object Storage знайдіть API Tokens у секції Account Details і натисніть Manage.
2. Натисніть Create API token.
3. Виберіть Account API token. Це простіший варіант, який працює, доки ви його не відкличете.
4. У секції Permissions виберіть Object Read & Write.
5. Обмежте токен тільки кошиком, створеним для STLViewer. Це безпечніше, ніж давати доступ до всіх кошиків.
6. Натисніть Create API token.

Не вибирайте права Admin. STLViewer вони не потрібні, а менші права безпечніші.

Cloudflare покаже значення, які потрібно скопіювати:

Збережіть ці значення в безпечному місці до завершення налаштування. Secret Access Key показується лише один раз. Якщо ви закриєте сторінку, не скопіювавши його, створіть новий токен.

Як endpoint використовуйте адресу, що закінчується на r2.cloudflarestorage.com. Не використовуйте публічну адресу кошика або власний домен.

Крок 3 - Підключіть кошик у STLViewer

1. Увійдіть до STLViewer.
2. Відкрийте сторінку Профіль.
3. Знайдіть картку Хмарне сховище і натисніть Підключити сховище.
4. Заповніть форму Підключити Cloudflare R2:

Префікс ключа необов'язковий. Якщо введете stlviewer, моделі зберігатимуться за шляхами на кшталт stlviewer/uploads/.... Залиште поле порожнім, якщо хочете зберігати файли на верхньому рівні кошика.

5. Натисніть Підключити. Кнопка залишається неактивною, доки обов'язкові поля не заповнені.

Перед збереженням підключення STLViewer перевіряє, чи може підключитися до кошика з цими даними. Якщо все правильно, картка покаже Cloudflare R2 (сумісний із S3) і позначку Підключено. Якщо щось не так, ви побачите помилку, а підключення не буде збережене.

Секретний ключ доступу шифрується перед збереженням. STLViewer ніколи не показує його знову і ніколи не надсилає його в браузер.

Користування власним сховищем

• Завантаження працює так само, як раніше. Нові моделі, завантажені після входу в обліковий запис, потрапляють у ваш кошик R2.
• Це можна перевірити в Cloudflare. Завантажте тестову модель, а потім відкрийте кошик у Cloudflare. Має з'явитися новий файл за шляхом на кшталт uploads/model/... або під вашим префіксом, якщо ви його вказали.
• Поширення і перегляд і далі працюють через STLViewer. Людині, яка відкриває посилання, не потрібен доступ до вашого облікового запису Cloudflare або кошика.
• Видалення моделі в STLViewer також видаляє файл із кошика. Цю дію не можна скасувати.
• Моделі все ще мають термін дії. Наразі кожна поширена модель має період зберігання. Коли він закінчується, STLViewer видаляє файл із вашого кошика R2. Якщо хочете зберегти оригінал назавжди, тримайте окрему власну копію.

Керування підключенням

Статус. Картка хмарного сховища може показувати Підключено, Потрібне повторне підключення або Доступ відкликано. Якщо є проблема, остання помилка з'явиться під статусом.

Якщо токен перестане працювати. Якщо ви видалите або заміните токен R2 у Cloudflare, STLViewer позначить підключення як Потрібне повторне підключення під час наступної спроби використати кошик. Поширені посилання не стануть сторінками 404. Відвідувачі побачать повідомлення "тимчасово недоступно", бо запис моделі ще існує, але STLViewer зараз не може отримати файл. Щоб виправити це, створіть новий токен R2 і підключіть кошик знову.

Відключення. Після натискання Відключити STLViewer попросить ввести DISCONNECT. Це навмисний захист, бо цю дію не можна скасувати всередині STLViewer. Відключення видаляє записи STLViewer для моделей, збережених у цьому кошику, тому їхні посилання перестають працювати. Файли в кошику R2 залишаються на місці.

Зміна кошика. Перемикання одним кліком немає. Спочатку відключіть поточний кошик, а потім підключіть новий.

Усунення проблем

"The access key or secret was rejected by the bucket." Ідентифікатор ключа або секретний ключ неправильний, або токен не має права запису. Скопіюйте обидва поля ще раз і переконайтеся, що токен має право Object Read & Write. Якщо ви не впевнені щодо секретного ключа, створіть новий токен.

"The bucket was not found at this endpoint." Перевірте назву кошика і endpoint. Endpoint має закінчуватися на r2.cloudflarestorage.com. Якщо кошик створено в конкретній юрисдикції, наприклад у ЄС, використайте endpoint із Settings -> S3 API цього кошика.

"Could not connect to the bucket with these settings." Найчастіше проблема в endpoint. Він має починатися з https:// і мати вигляд https://<account-id>.r2.cloudflarestorage.com.

"An active storage connection already exists." У вас уже підключено кошик. Спочатку відключіть його.

Поширені запитання

Чи потрібне власне сховище, щоб користуватися STLViewer?

Ні. Вбудоване сховище є стандартним і працює для всіх, зокрема для анонімних завантажень. Підключення власного кошика Cloudflare R2 необов'язкове.

Чи треба налаштовувати CORS на кошику?

Ні. STLViewer передає файли через застосунок, тому браузер ніколи не читає напряму з вашого кошика.

Чи перенесе підключення мої наявні моделі?

Ні. У кошик R2 потрапляють тільки нові моделі, завантажені після входу в обліковий запис. Старіші моделі залишаються у вбудованому сховищі й працюють як раніше.

Що станеться з моїми файлами, якщо я відключуся?

Файли залишаться у вашому кошику R2. STLViewer видаляє тільки власні записи моделей, тому старі посилання перестають працювати.

Чи можу я тримати модель у своєму кошику безстроково?

Поки що ні. Сьогодні кожна модель усе ще має дату завершення. Коли вона настає, файл видаляється з вашого кошика. Можливість безстрокового зберігання для моделей у власному сховищі планується, але ще недоступна.

Дивіться також

• Огляд можливостей STLViewer.online
• Як вбудувати 3D-модель на сайт