docker-py初始化Swarm自定义name报400：swarm spec must be named default

这个报错是Docker引擎侧的硬限制导致，和docker-py SDK本身的逻辑无关：

• Docker Swarm模式从正式发布起，就强制要求Swarm集群的name字段必须固定为default，从未开放过自定义Swarm名称的能力，不管是直接调用底层API、还是使用官方docker swarm init命令，都不支持修改这个字段。
• docker-py文档标注swarm.init接口支持name属性，属于SDK文档和Docker引擎实际约束不匹配的问题：SDK层确实预留了该参数的传参入口，但参数传递到Docker daemon后会触发合法性校验，只要传入的名称不是default就会直接返回400错误，和你看到的报错内容完全一致。
• 你观察到报错请求发往/swarm/update而非init接口，是docker-py的内部实现逻辑导致：swarm.init方法会先完成基础Swarm初始化，再调用update接口应用你传入的自定义配置，更新名称这一步刚好触发了daemon的校验规则，最终抛出异常。

• 初始化Swarm时直接省略name参数，不要传自定义名称，Docker会自动将Swarm名称设置为要求的default，初始化流程可以正常执行。
• 不要尝试在Swarm初始化完成后调用swarm.update接口修改名称，该操作同样会触发相同的校验报错，目前所有稳定版本的Docker引擎都没有开放修改Swarm名称的能力。
• 如果业务上需要区分不同的Swarm集群，不要依赖Swarm本身的name字段，可以通过给节点添加自定义标签、在Swarm配置中添加自定义元数据标签的方式实现集群标识需求。

内容的提问来源于stack exchange，提问作者George Violettas