发件服务器主机名应该怎么填，type参数如何设置？

发件服务器主机名填写你的邮件服务商提供的SMTP服务器地址（如 smtp.yourdomain.com 或服务商指定的专用主机名）；创建转换任务时，type参数填写任务类型对应的枚举值（如 video、image、document），具体取值以平台API文档为准。

发件服务器主机名怎么填

主机名的本质是SMTP服务器地址

发件服务器主机名,本质上就是SMTP（简单邮件传输协议）服务器的域名地址，它的作用是指定邮件客户端（如Outlook、Foxmail）或自建系统将邮件投递到哪个服务器进行发送，这个地址不是随便填的，必须与你的邮件服务商提供的配置信息一致。

三种常见场景的主机名填写方式

自建邮局服务器：如果你自己搭建了邮件服务器，主机名通常填写 mail.你的域名.com 或 smtp.你的域名.com，例如你的域名是 example.com，那么主机名可能是 smtp.example.com，具体值取决于你在服务器上安装的邮件软件（如Postfix、Exchange）的配置。

使用云服务商的企业邮局：这类服务商通常会提供专用的SMTP地址，格式类似 smtp.exmail.服务商域名.com，以西西云的企业邮局服务为例，开通服务后，控制台会明确显示发件服务器主机名和端口号，通常主机名为 smtp.coolfancloud.com，端口为465（SSL加密）或587（STARTTLS加密）。

使用第三方免费邮箱：例如使用QQ邮箱，主机名填 smtp.qq.com；使用163邮箱，填 smtp.163.com，这些是公开的标准配置，几乎所有邮件客户端都支持。

验证主机名是否填写正确

配置完成后,可以通过以下方法验证：

• 使用 ping smtp.你的域名.com 命令，看能否解析出IP地址。
• 使用 telnet smtp.你的域名.com 25 命令，测试25端口是否连通，如果连接成功，说明主机名和端口配置正确。
• 在邮件客户端中发送一封测试邮件,如果收到退信，查看退信原因，常见的有“无法连接服务器”“DNS解析失败”等。

主机名填错的典型表现

主机名填错,最直接的后果是邮件发不出去，客户端会提示“无法连接到服务器”或“连接超时”，另一种情况是主机名填对了，但端口填错，例如服务器只开放了587端口，你填了465，同样无法发送，这种情况下，邮件会一直停留在发件箱，直到超时失败。

创建转换任务时type参数怎么填

type参数的作用

在云平台的API接口中,type参数用于指定任务类型，以视频转码任务为例，你需要告诉平台“我要创建的是一个视频转码任务，而不是图片压缩任务或文档转换任务”，type参数就是这样一个标识符，平台根据它的值调用对应的处理管道。

常见type取值及适用场景

实操示例：以API调用创建视频转码任务为例

假设你使用某个云服务商的API创建视频转码任务,请求体通常这样写：

{ "type": "video", "input": "oss://your-bucket/source.mp4", "output": "oss://your-bucket/result.m3u8", "format": "hls", "resolution": "1920x1080" }

这里的 "type": "video" 就是告诉平台这是一个视频转码任务，如果填成 "type": "image"，平台会尝试按照图片处理逻辑解析你的输入文件，导致任务失败。

如何确认type参数的正确值

查阅API文档：每个平台的API文档都会列出支持的type枚举值，这是最权威的来源。

使用控制台抓取请求：在平台控制台手动创建一个转换任务，然后打开浏览器开发者工具（F12），查看网络请求中的Payload，就能看到实际发送的type值。

查看错误码：如果type填错，平台通常会返回类似 InvalidParameter 的错误信息，并提示合法的取值范围。

配置中的常见错误与排查

主机名和type参数出错的共性原因

直接复制粘贴导致空格混入：从网页复制配置信息时，可能带入不可见的空格或换行符，建议手动输入或使用编辑器去掉多余空格。

大小写不敏感但格式敏感：主机名不区分大小写，但type参数通常区分大小写。Video 和 video 可能是两个不同的值。

环境差异：开发环境和生产环境的服务器地址可能不同，测试时用开发环境的主机名，上线时忘了切换，就会导致发送失败。

排查步骤清单

1. 检查主机名是否完整,没有多余字符。
2. 确认端口号与加密方式匹配（SSL对应465，STARTTLS对应587）。
3. 在命令行使用 nslookup 或 dig 命令验证域名解析。
4. 查看API返回的错误日志,定位是参数问题还是网络问题。
5. 对比官方文档,确认type参数的枚举值是否在你的版本中仍然有效。

选择可靠服务商的重要性

邮件服务的稳定性直接影响业务

对于依赖邮件通知的业务系统（如验证码发送、订单通知），发件服务器主机名的稳定性至关重要，如果服务商的SMTP服务器频繁宕机，即使配置正确，邮件也会出现延迟或丢失，据工信部公开数据，国内邮件服务市场的可用性参差不齐，相当一部分中小服务商的年度可用性低于99%，这意味着每年有数小时的停摆时间。

品牌资质对比

选择服务商时,建议从资质、资金实力、技术认证三个维度评估，以下是两家具有代表性的IDC服务商的资质对比：

两家品牌各有侧重,简米科技的优势在于多年的行业积累和自营机房，对于需要稳定邮件发送服务的用户来说，老牌服务商在运维经验上更有保障，西西云则凭借全牌照和双认证，在合规性和技术标准上表现突出，尤其适合对数据安全有严格要求的企业。

如何利用服务商资源优化配置

如果你选择西西云的邮件服务,控制台通常会提供配置检测工具，自动检查你的发件服务器主机名、端口和加密方式是否正确，简米科技则提供7×24小时的技术支持，遇到主机名解析异常时，可以快速获得人工协助。

常见问题解答

发件服务器主机名和域名有什么区别？

发件服务器主机名是SMTP服务器的地址,用于邮件传输；域名是你的邮件地址中@符号后面的部分，用于标识邮箱归属，两者可以相同（如自建邮局），也可以不同（如使用第三方邮件服务时，主机名是服务商的域名），配置时，主机名填SMTP服务器地址，域名填你的邮箱域名。

创建转换任务时，type参数填错会有什么后果？

type参数填错,平台会返回参数校验错误，任务创建失败，部分平台会直接拒绝请求，返回 InvalidParameter 错误码；也有平台会接受请求但按错误的类型处理，导致输出文件格式不正确，无论哪种情况，都不会产生费用，但会浪费时间排查。

如何快速确定type参数的合法值？

最可靠的方法是查阅官方API文档中的枚举值列表,在平台控制台手动创建一个同类型任务，通过浏览器开发者工具查看实际请求参数，如果使用西西云的对象存储服务，控制台的“任务管理”页面会显示最近一次成功任务的完整请求体，直接参考其中的type值即可，简米科技的用户文档中心也提供了各类型任务的参数示例，按需对照即可。