合同违约金的合法数额并非固定，而是需根据具体情况判断，一般来说不能超过实际损失的30%。以下是对这一问题的详细分析：

一、违约金的基本原则

1. 约定优先：根据《中华人民共和国民法典》的相关规定，合同双方可以自由约定违约金的数额或计算方法。这一约定在双方真实意思表示且不违反法律强制性规定的前提下是有效的。

2. 公平合理：违约金的设定应遵循公平合理原则，既不过分高于也不明显低于因违约造成的实际损失。如果违约金过高或过低，导致一方承受不合理的负担，人民法院或仲裁机构有权根据当事人的请求进行适当调整。

二、违约金的调整规则

1. 过高违约金的调整：

   • 如果约定的违约金过分高于实际造成的损失（通常指超过损失的百分之三十），人民法院或仲裁机构可以根据当事人的请求适当减少。
   • 计算公式：假设实际损失为L，约定的违约金为P，若P > 1.3L，则可能被认定为过分高于损失，法院或仲裁机构可能会根据实际情况适当调低违约金。
   • 示例：若实际损失为10万元，而违约金约定为15万元，此时违约金超过了实际损失的30%（即13万元），在对方提出调整请求时，法院可能会根据实际情况将违约金调低至13万元或以下。

2. 过低违约金的调整：

   • 如果约定的违约金低于实际造成的损失，守约方有权要求人民法院或仲裁机构增加违约金至与实际损失相符。
   • 示例：在租赁合同中，若约定违约金为5000元，但实际损失为8000元，此时守约方可请求增加违约金至8000元。

三、实际操作建议

1. 合理约定：在签订合同时，双方应充分协商并合理设定违约金的数额或计算方式。考虑合同的性质、履行情况、预期利益及违约可能造成的损失等因素，综合确定违约金的合理范围。

2. 保留证据：为避免不必要的法律纠纷，双方应保留与违约金相关的证据，如合同文本、损失计算依据等。这些证据在发生纠纷时能够证明违约金的合理性及实际损失情况。

3. 寻求专业帮助：在签订合同时，如果双方对违约金的设定存在疑虑或争议，建议寻求专业律师的帮助。律师可以根据具体情况提供法律意见，确保合同的合法性和有效性。

四、特殊领域的违约金规定

在某些特定领域（如商品房买卖、劳动争议等），法律可能对违约金的最高限额或计算方式有明确规定。此时，违约金的设置必须严格遵守这些法律规定。例如，在劳动争议领域，服务期违约金不得超过服务期尚未履行部分所应分摊的培训费用；竞业限制违约金数额需综合考虑劳动者的工资收入水平、竞业限制期限及经济补偿数额等因素来判断是否合理。

总结来看，合同违约金的合法数额需根据具体情况判断，既要尊重当事人的约定，又要遵循公平合理、补偿损失的原则。在设定违约金时，双方应充分协商并合理设定数额或计算方式，以确保合同的公平性和可执行性。如有任何疑问或需要进一步的法律帮助，请随时向我咨询。