准备工作
挂载存储桶，需要进行以下准备工作。
一台 Lighthouse 服务器。
一个同地域的轻量对象存储（Lighthouse 版）的存储桶。
功能概述
用户可以在轻量应用服务器控制台将存储桶挂载到 Lighthouse 服务器上，生成一个挂载点。每个挂载点，包含四个元素：服务器、服务器挂载目录、存储桶、存储桶挂载目录。
挂载成功后，服务器的挂载目录和存储桶的挂载目录之间的数据是完全同步的，用户可以像使用本地盘一样使用 COS 的存储桶空间。
说明：
使用步骤
挂载存储桶
方式一：在存储桶页面进行挂载
1. 进入 控制台 的对象存储页面，选择需要挂载的存储桶。进入存储桶详情页，选择挂载服务器。
2. 单击挂载到服务器，开始创建挂载点。填写以下信息：
选择同地域 Lighthouse 服务器。
服务器挂载目录。
存储桶挂载目录。
确认挂载授权。创建挂载点之前，必须授权当前 Lighthouse 服务器匿名访问存储桶挂载目录的权限。详情可参见 挂载授权。
高级参数（可选）。
并发数：挂载传输的并发数，可根据服务器 CPU 核数适当调整。假如服务器 CPU 核数为N，默认推荐值为
max(10，2*N)。分块大小：挂载传输中，大文件会使用分块上传，分块大小默认为10MB。由于分块上传最多支持10000块，如果需要传输超出100GB的大文件，可适当调大该参数。
3. 单击确定，开始挂载。通过挂载状态可以查看当前挂载任务的完成情况，单击右侧的 
注意：
挂载是一个异步任务，可能需要执行几秒～1分钟。可以通过挂载状态查看当前挂载任务的完成情况。
方式二：在 Lighthouse 服务器页面进行挂载
1. 进入 控制台 的服务器页面，选择需要被挂载的服务器。在服务器详情页，选择对象存储 > 挂载存储桶。
2. 单击挂载存储桶，开始创建挂载点。填写以下信息：
选择同地域的存储桶。
服务器挂载目录。
存储桶挂载目录
确认挂载授权。创建挂载点之前，必须授权当前 Lighthouse 服务器匿名访问存储桶挂载目录的权限。详情可参见 挂载授权。
高级参数（可选）。
并发数：挂载传输的并发数，可根据服务器 CPU 核数适当调整。假如服务器 CPU 核数为 N，默认推荐值为
max(10，2*N)。分块大小：挂载传输中，大文件会使用分块上传，分块大小默认为10MB。由于分块上传最多支持10000块，如果需要传输超出100GB的大文件，可适当调大该参数。
3. 单击确定，开始挂载。通过挂载状态可以查看当前挂载任务的完成情况，单击右侧的 
注意：
挂载是一个异步任务，可能需要执行几秒～1分钟，可以通过挂载状态查看当前挂载任务的完成情况。
查看文件
完成挂载后，登录 Lighthouse 服务器，进入服务器挂载目录。此时，存储桶挂载目录和服务器挂载目录的内容互相同步、完全一致。
进入服务器挂载目录，写入一个新的文件。
cd /lhcos-dataecho 111111 > test.txt
进入控制台，该存储桶对应的挂载目录，发现 test.txt 已经写入。
回到服务器挂载目录，删除 test.txt 文件。
cd /lhcos-datarm ./test.txt
进入控制台，查看存储桶的挂载目录，相应的文件也不存在了。
修改挂载配置
注意：
如果需要更修改挂载服务器、挂载存储桶，或者修改分块参数和并发参数，必须移除挂载后重新进行挂载。
在挂载配置中，单击编辑，可以对服务器挂载目录、存储桶挂载目录进行修改。挂载配置的修改，需要一定时间生效，可以通过挂载状态查看修改是否完成。
移除挂载
在挂载配置中，单击移除，可以移除挂载。移除挂载点的同时，挂载授权也会被删除。服务器将无法查看、同步文件，但文件不会被删除，将继续保留在存储桶内。
默认共享存储桶和共享存储超值资源包
注意：
默认共享存储桶仅在新购 Lighthouse 实例时才能创建。
默认共享存储桶
默认共享存储桶是一类特殊的轻量 COS 存储桶，同地域的服务器共享这个存储桶的空间，命名格式固定为：
lhcos-XXXXX-${appid}。其中，XXXXX 为 5 位随机字符串，appid 为当前账户的 appid。用户在 Lighthouse 实例购买页新购服务器时，如果在购买页勾选了一键挂载共享存储桶或购买了共享存储超值资源包。在 Lighthouse 服务器购买完成后，会自动挂载同地域的默认共享存储桶，挂载目录遵循以下格式：
服务器挂载目录（默认）：/lhcos-data
存储桶挂载目录（默认）：/lhcos-data
如果一次性新购多个服务器，这些服务器会共享同一个默认存储桶的挂载目录。也就是说，相当于拥有了一个共享的存储空间。如果后续在该地域继续购买新的服务器，也支持默认挂载到同一个默认存储桶。如果您不希望共享挂载空间，或希望修改服务器或存储桶的挂载目录，也可以在存储桶挂载页面或者服务器挂载页面，修改挂载配置或移除挂载。
共享存储超值资源包
对于从未购买过轻量对象存储（Lighthouse 版）资源包的用户，在服务器购买页购买 Lighthouse 服务器的同时支持加购一元共享存储超值存储包（包含10GB标准存储容量，1GB外网下行流量）。一元包购买成功后，会自动进行以下操作：
为您开通轻量对象存储（Lighthouse 版）服务、创建相应的服务角色。
在服务器所在地域创建默认共享存储桶，命名格式固定为：
lhcos-XXXXX-${appid}。其中，XXXXX 为 5 位随机字符串，appid 为当前账户的 appid。本次订单新购的服务器，会自动挂载默认共享存储桶。
服务器挂载目录（默认）：/lhcos-data
存储桶挂载目录（默认）：/lhcos-data
使用限制
1. 一个服务器最多可以创建10个挂载点。不同挂载点挂载的存储桶可以相同，但存储桶挂载目录不能相同。
2. 服务器挂载目录不支持使用软链接；创建挂载点时，服务挂载目录必须为空，不得包含真实存在的本地文件。
3. 服务器系统盘 /tmp 目录至少具有 10GB的空间。
4. 挂载功能仅支持 Linux 系统（不包含自定义镜像）的服务器使用。Linux 系统各类镜像具体的支持情况如下。
类型 | 镜像类型 | 是否支持 |
系统镜像 | CentOS 7.6 | 支持 |
| CentOS Stream 8 | 支持 |
| CentOS Stream 9 | 支持 |
| OpenCloudOS 8 | 支持 |
| OpenCloudOS 9 | 支持 |
| Ubuntu Server 18.04.1 LTS | 支持 |
| Ubuntu Server 20.04 LTS | 支持 |
| Ubuntu Server 22.04 LTS | 支持 |
| Ubuntu Server 24.04 LTS | 支持 |
| Debian 10.2 | 支持 |
| Debian 11.1 | 支持 |
| Debian 12.0 | 支持 |
应用模板 | 宝塔Linux面板 - OpenCloudOS 9 | 支持 |
| WordPress - CentOS 7.8 | 支持 |
| Halo建站 - Ubuntu Server 22.04 LTS 64bit | 支持 |
| WooCommerce - CentOS 7.6 | 支持 |
| LAMP - Ubuntu Server 24.04 LTS 64bit | 支持 |
| OpenFaaS - CentOS 7.6 | 支持 |
| SRS音视频服务器 - Ubuntu Server 20.04 LTS | 支持 |
| Typecho - CentOS 7.9 | 支持 |
| Cloudreve - CentOS 7.8 | 支持 |
| Matomo - CentOS 7.6 | 支持 |
| Node.js - OpenCloudOS Server 9 | 支持 |
| Cloud Studio IDE - CentOS 7.6 | 支持 |
| Theia IDE - Ubuntu Server 18.04.1 LTS | 支持 |
| 翼龙面板 - Ubuntu Server 22.04 LTS | 支持 |
| 幻兽帕鲁Ubuntu - Ubuntu Server 22.04 LTS | 支持 |
| Docker CE - Ubuntu Server 24.04 LTS | 支持 |
| K3s - Ubuntu Server 24.04 LTS | 支持 |
| 1Panel Linux - Ubuntu Server 22.04 LTS | 支持 |
| LobeChat - Ubuntu Server 22.04 LTS | 支持 |
| Dify -Ubuntu Server 22.04 LTS | 支持 |
| 长安链 ChainMaker - CentOS 7.6 | 支持 |
| 互动直播房间服务 - CentOS 7.9 | 支持 |
| Lightwings - CentOS 7.9 | 支持 |
容器镜像 | OpenCloudOS8-Docker26 | 支持 |
| CentOS7.6-Docker26 | 支持 |
| Ubuntu22.04-Docker26 | 支持 |
| Debian12-Docker26 | 支持 |
| CentOSStream9-Docker26 | 支持 |
自定义镜像 | 全部不支持 | \\ |
常见问题
挂载授权
挂载存储桶之前，必须授权当前 Lighthouse 服务器匿名访问存储桶挂载目录的权限。确认授权后，在该 Lighthouse 服务器上可以匿名访问相应的目录。修改挂载配置，如涉及修改存储桶挂载目录，授权的范围也会更新为新的挂载目录。移除挂载，相应的授权也会移除。
挂载状态异常
在控制台存储桶挂载配置页面或服务器挂载配置页面，可以查看挂载状态。挂载状态可分为三种：
挂载异常：由于挂载工具安装失败、挂载点未运行等原因，导致挂载状态产生异常。此时可以尝试移除挂载后，重新挂载进行修复。
挂载成功：代表挂载点正在正常运行中。
挂载中：代表正在执行挂载任务，需要等待一段时间。
挂载异常的可能原因
1. 磁盘空间不足导致的挂载失败
挂载工具上传下载都会使用磁盘文件缓存，当
/tmp 目录剩余空间少于10GB时，会导致挂载失败。
2. 服务器挂载目录为软链接
服务器挂载目录必须为真实目录，挂载到软链接、快捷方式等会导致挂载失败。
3. 服务器挂载目录已包含本地文件
执行挂载时，如果服务器挂载目录不是空目录，已包含了文件，执行挂载将会报错。
4. 服务器当前处于关机状态
服务器当前必须处于开机状态，tat agent 和挂载工具才能正常运行，否则执行挂载会失败，已挂载点会显示挂载状态异常。
5. 服
务器未安装 tat agent 或 tat agent 不在线。
执行挂载和检测挂载点的状态均依赖于 tat agent，若服务器未安装 tat agent 或 tat agent 不在线，执行挂载会失败，已挂载点会显示挂载状态异常。
6.
查找不到挂载点（
Not found the mount path）。
可能原因：挂载工具异常退出、用户通过命令行手动卸载挂载工具等。建议移除挂载后，尝试重新挂载。
一个服务器最多可以挂载几个存储桶
一个服务器最多可以创建10个挂载点。不同挂载点挂载的存储桶可以相同，但存储桶挂载目录不能相同。也就是说，（服务器 id，存储桶，存储桶挂载目录）这个元组必须是唯一。
能否支持挂载 COS 存储桶
当前 Lighthouse 控制台的自动挂载功能仅支持将轻量对象存储（Lighthouse 版）服务的存储桶挂载到 Lighthouse 服务器。如果需要将 COS 存储桶挂载到 Lighthouse 服务器，请手动安装 GooseFS-Lite 工具，通过命令行完成挂载等流程，详情请参见 GooseFS-Lite 工具。
