diff --git a/pkg/multicloud/qcloud/doc.go b/pkg/multicloud/qcloud/doc.go
index 3c4582b636..494fbada82 100644
--- a/pkg/multicloud/qcloud/doc.go
+++ b/pkg/multicloud/qcloud/doc.go
@@ -13,3 +13,85 @@
 // limitations under the License.
 
 package qcloud // import "yunion.io/x/onecloud/pkg/multicloud/qcloud"
+
+/*
+Network Pre Conditions
+
+若是不开放公网，则需要开放以下域名的443和80端口, 避免部分资源同步异常或创建资源失败
+
+cvm.tencentcloudapi.com
+cvm.ap-shanghai-fsi.tencentcloudapi.com
+cvm.ap-shenzhen-fsi.tencentcloudapi.com
+
+vpc.tencentcloudapi.com
+vpc.ap-shanghai-fsi.tencentcloudapi.com
+vpc.ap-shenzhen-fsi.tencentcloudapi.com
+
+cloudaudit.tencentcloudapi.com
+cloudaudit.ap-shanghai-fsi.tencentcloudapi.com
+cloudaudit.ap-shenzhen-fsi.tencentcloudapi.com
+
+cbs.tencentcloudapi.com
+cbs.ap-shanghai-fsi.tencentcloudapi.com
+cbs.ap-shenzhen-fsi.tencentcloudapi.com
+
+account.api.qcloud.com
+
+clb.tencentcloudapi.com
+clb.ap-shanghai-fsi.tencentcloudapi.com
+clb.ap-shenzhen-fsi.tencentcloudapi.com
+
+lb.api.qcloud.com
+wss.api.qcloud.com
+cns.api.qcloud.com
+vpc.api.qcloud.com
+billing.tencentcloudapi.com
+cam.tencentcloudapi.com
+monitor.tencentcloudapi.com
+
+cos.ap-beijing.myqcloud.com
+service.cos.myqcloud.com
+cos.ap-bangkok.myqcloud.com.
+bj.file.myqcloud.com.
+tj.file.myqcloud.com.
+cd.file.myqcloud.com.
+cq.file.myqcloud.com.
+gz.file.myqcloud.com.
+hk.file.myqcloud.com.
+cos.ap-mumbai.myqcloud.com.
+cos.ap-nanjing.myqcloud.com.
+cos.ap-seoul.myqcloud.com.
+sh.file.myqcloud.com.
+cos.ap-shanghai-fsi.myqcloud.com.
+cos.ap-shenzhen-fsi.myqcloud.com.
+sgp.file.myqcloud.com.
+cos.ap-tokyo.myqcloud.com.
+ger.file.myqcloud.com.
+cos.eu-moscow.myqcloud.com.
+cos.na-ashburn.myqcloud.com.
+cos.na-siliconvalley.myqcloud.com.
+ca.file.myqcloud.com.
+3jytr9q1.dayugslb.com.
+60icvusw.dayugslb.com.
+5ekm872f.dayugslb.com.
+r5mfqoyl.dayugslb.com.
+
+Permission Pre Conditions
+若仅需要同步资源, 则需要赋予账号以下权限
+QCloudFinanceFullAccess
+QcloudCVMReadOnlyAccess
+QcloudCamReadOnlyAccess
+QcloudCOSReadOnlyAccess
+QcloudAuditReadOnlyAccess
+QcloudMonitorReadOnlyAccess
+
+若需要资源读写，需要赋予账号以下权限
+QCloudFinanceFullAccess
+QcloudCVMFullAccess
+QcloudCamFullAccess
+QcloudCBSFullAccess
+QcloudEIPFullAccess
+QcloudCOSFullAccess
+QcloudAuditFullAccess
+QcloudMonitorFullAccess
+*/