> ## Documentation Index > Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt > Use this file to discover all available pages before exploring further. # SFTP Server 端口 > 知行之桥SFTP Server 端口的配置和使用指南，该端口用于定义向内置 SFTP 服务器进行认证的客户端配置文件。 export const TrustedIp = () => <>

可信 IP 地址 部分提供以下功能：

功能描述
添加输入新的 IP 地址范围。
编辑修改选定的 IP 地址范围。
删除从列表中删除选定的 IP 地址范围。

以下限制适用于此功能：

为了让客户端能够访问服务器，需要有清晰的网络路径。在云环境中，可能需要在三个地方进行更改：

• 云控制台中的网络规则。

• 托管应用程序的机器上的防火墙规则。例如，在使用 Amazon AMI 时，可以使用 简单防火墙（UFW）来允许所需端口上的流量。Linux 环境中的常见策略是将流量从低于 1024 的端口转发到高于 1024 的非标准端口，同时将应用程序配置为使用非标准端口。这可以避免与非 root 用户绑定到低于 1024 的端口相关的权限问题。

• 安全 选项卡的 网络访问 部分。

 ; export const NameDescription = ({extraRows}) => {extraRows}
设置 描述
端口 Id 端口的静态、唯一标识符。
端口类型 显示端口类型及其用途的描述。
端口描述 一个可选字段，用于提供端口及其在流中的角色的自由格式描述。
; export const SlasTab = ({siteName = "知行之桥"}) => <>

与配置服务级别协议 (SLA) 相关的设置。

SLA 允许配置预期流程中端口发送或接收的数据量，并设置预期达到该数据量的时间范围。当 SLA 未达到时，{siteName} 会发送电子邮件警告用户，并将 SLA 标记为 存在风险，这意味着如果 SLA 未能尽快达到，则会被标记为 已违反。这让用户有机会介入并确定 SLA 未达到的原因，并采取适当的措施。如果在风险时间段结束时仍未达到 SLA，则会将 SLA 标记为已违反，并再次通知用户。

要定义 SLA，请启用 预期数据量，然后点击 设置 选项卡。

SLA Empty

以下示例显示了为端口配置的 SLA，该端口预计在周一至周五每天接收 1000 个文件。如果尚未收到 1000 个文件，则会在时间段结束前 1 小时发送风险通知。

SLA Configuration Example 如果有必要，可以关闭 SLA 通知。这在维护窗口期间非常有用。点击导航栏上的 设置，然后跳转到 通知 > 通用通知。点击平板和铅笔图标进行编辑，并取消勾选 SLA 通知 设置。 ; export const AlertsTab = ({siteNameShort = "知行之桥"}) => <>

与配置通知相关的设置。

在执行服务级别协议 (SLA) 之前，需要设置电子邮件通知以接收通知。默认情况下，{siteNameShort} 使用 通知 选项卡上的全局设置。要为此端口使用其他设置，请启用 覆盖全局设置。

默认情况下，错误通知处于启用状态，这意味着每当出现错误时都会发送电子邮件。要关闭错误通知，请取消选中 启用 复选框。

输入 主题（必填），然后（可选）输入以逗号分隔的 收件人 电子邮件列表。

; export const Message = () => <>

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹 选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案 端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。
; export const MiscConnector = () => <>

特殊设置适用于特定用例。

设置 描述
其他设置 允许在以分号分隔的列表中配置隐藏的端口设置，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。
; export const Logging = () => <>

用于管理日志创建和存储的设置。

设置 描述
日志级别 指定要记录在端口日志目录中的信息类型：
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构 指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本 指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。
; export const ProfileLogging = () => <>

用于管理日志创建和存储的设置。

设置 描述
日志级别 端口生成的日志的详细程度。当请求支持时，请将其设置为 Debug。
日志轮换间隔 创建新日志文件之前等待的天数。
日志删除间隔 删除旧日志文件之前等待的天数。
; export const MacrosExamples = ({extraMacros = []}) => <>

某些宏（例如 %Ext% 和 %ShortDate%）不需要参数，但其他宏则需要。所有带有参数的宏都使用以下语法：%Macro:argument%

以下是带有参数的宏的一些示例：

还可以创建更复杂的宏，如以下示例所示：

; export const MacrosTable = ({siteName = "知行之桥", extraMacros = []}) => <>

在文件命名策略中使用宏可以提高组织效率和对数据的上下文理解。通过将宏合并到文件名中，可以动态地包含相关信息，例如标识符、时间戳和消息头信息，从而为每个文件提供有价值的上下文。这有助于确保文件名反映对组织重要的详细信息。

{siteName} 支持这些宏，它们都使用以下语法：%Macro%。

{extraMacros.map(item => )}
宏描述
ConnectorID替换为端口的 ConnectorID。
Ext替换为端口当前正在处理的文件的文件扩展名。
Filename替换为端口当前正在处理的文件的文件名（包括扩展名）。
FilenameNoExt替换为端口当前正在处理的文件的文件名（不带扩展名）。
MessageId计算端口输出的消息的 MessageId。
RegexFilename:pattern将正则表达式模式应用于端口当前正在处理的文件的文件名。
Header:headername替换为端口正在处理的当前消息的目标消息头（headername）的值。
LongDate以常规格式计算系统的当前日期时间（例如，2024 年 1 月 24 日星期三）。
ShortDate以 yyyy-MM-dd 格式计算系统的当前日期时间（例如 2024-01-24）。
DateFormat:format以指定格式（format）计算系统的当前日期时间。有关可用的日期时间格式，请参阅 示例日期格式。
Vault:vaultitem计算指定保管库项目的值。
{item.name} {item.description}
; export const companyName = "知行软件"; export const siteNameShort = "知行之桥"; export const siteName = "知行之桥"; 每个 SFTP Server 端口都定义一个唯一的客户端配置文件，可用于向 {siteNameShort} SFTP Server 进行认证。 ## 核心功能 * 内置基于 SSH 的安全文件服务器，支持多用户访问 * 灵活的认证方式，包括密码、公钥以及 Windows/AD 集成（Windows/AD 集成仅在 .NET 版中可用） * 独立的用户目录，支持自定义文件夹结构和附加路径 * 高级安全特性，包括登录尝试锁定和 IP 限制 * 支持临时文件扩展名以及操作完成后的文件自动移动 ## 概述 {siteNameShort} SFTP Server 端口主要在[个人设置](../getting-started/administration/profiles)页面中配置。然后，可以为每个应有权访问服务器的交易伙伴创建单独的 SFTP Server 端口。SFTP Server 端口定义交易伙伴的凭据（用户名、密码和/或公钥），并在服务器上提供唯一的主目录。 每个用户的主目录都包含一个 *Send* 文件夹（客户端可从中下载文件）和一个 *Receive* 文件夹（客户端可向其中上传文件）。您可以在[高级选项卡](#高级选项卡)上重命名这些文件夹。SFTP 客户端没有访问 SFTP 服务器根目录的权限，这意味着 SFTP 客户端连接后应始终 *cd* 到 Send 或 Receive 目录。 SFTP Server 还支持 Windows/AD 认证。有关详细信息，请参阅 [Windows 身份验证](#windows-身份验证)。 ### 视频资源 观看此短视频，了解如何配置 SFTP Server。