如何查询 API 地址和密钥?
方法一:
如果仅需要短时间预览用的 API 地址,可使用下方规格拼接:
${X_IDE_SPACE_KEY}--${PORT}.app.cloudstudio.work/ # 举例:hfrsgm--8434.app.cloudstudio.work/
其中
${X_IDE_SPACE_KEY}
可以通过浏览器地址最前面的六个字符查询到,${PORT}
则是启动的 Ollama 服务的端口号。
方法二:
说明:
Ollama 默认不支持 api key 鉴权,api 分享可能被滥用。为防止这种情况,可以通过 caddy 作为反向代理,来实现 Ollama API key 鉴权。
操作如下:
1. 安装 caddy。
sudo apt update -ysudo apt install -y debian-keyring debian-archive-keyring apt-transport-httpscurl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpgcurl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.listsudo apt updatesudo apt install caddy
2. 编写 caddy 配置文件:
/etc/caddy/Caddyfile
,可通过以下命令创建配置:cat <<EOF > /etc/caddy/Caddyfile:8435 {# Define a matcher for authorized API access@apiAuth {header Authorization "Bearer {env.OLLAMA_API_KEY}"}# Proxy authorized requestsreverse_proxy @apiAuth http://localhost:8434 {header_up Host {http.reverse_proxy.upstream.hostport}}# Define a matcher for unauthorized access@unauthorized {not {header Authorization "Bearer {env.OLLAMA_API_KEY}"}}# Respond to unauthorized accessrespond @unauthorized "Unauthorized" 401 {close}}EOF
3. 设置 API KEY。
3.1 设置新 API KEY:
export OLLAMA_API_KEY=`echo "sk-ollama-$(openssl rand -hex 16)"`echo $OLLAMA_API_KEY
3.2 保存 API KEY 便于后续使用:
echo "export OLLAMA_API_KEY=$OLLAMA_API_KEY" > /etc/caddy/ollama_api_key
3.3 设置 API KEY 为已保存的 API_KEY:
source /etc/caddy/ollama_api_keyecho $OLLAMA_API_KEY
3.4 查看当前 API KEY:
echo $OLLAMA_API_KEY
4. 启动 caddy。
注意:
需要先执行步骤3,设置 API KEY,然后再启动 caddy。
上述配置设置了 caddy 的端口是 8435。
caddy run --config /etc/caddy/Caddyfile &
5. 验证
不带 API KEY 的请求返回 401:
curl -i http://localhost:8435

带 API KEY 的请求正常:
curl -i http://localhost:8435 -H "Authorization: Bearer sk-ollama-d8684b74b0bb93afaf0ea677629a2969"

6. 更新 API KEY。
重新执行步骤 3 和步骤 4 。
如何获取预览地址?
1. 在终端输入
python3 -m http.server 「端口号」
,这里的端口号是您的 web 预览服务的端口号。
2. 复制当前工作空间的 url,如:
hfrsgm.ap-shanghai.cloudstudio.work
。
3. 新建浏览器页面,输入
https://hfrsgm--18080.ap-shanghai.cloudstudio.work/
(其中关键字段与工作空间 url 关键字一致),即可预览。
各个规格的自动关机策略?
CPU 空间:不关闭标签页,则根据编辑器内休眠时间断连;关闭标签页,则10分钟自动断连。
免费基础 GPU 空间:不关闭标签页,则不关机;关闭标签页,则10分钟自动关机(预览不保活)。
进阶型 GPU 空间:不自主关机,用户控制开关/销毁。
wget frp 库失败怎么处理?
我们在 cnb.cool 代码仓库建立了一个同样的 frp 库,https://cnb.cool/cloudstudio-toolkits/VaalaCat/frp-panel/-/releases/tag/v0.1.6;
需要拉包安装的可以用以下命令 wget: